Base
de Questões de Concurso Público.

Q-Api-Key: qb_SuaChaveAqui

A chave é prefixada com qb_ seguido de 40 caracteres aleatórios. Mantenha-a em segredo — nunca exponha em código público ou repositórios. Se necessário, redefina-a pelo suporte.

{
  "page":  1,      // página atual
  "size":  10,     // itens nesta página
  "pages": 63,     // total de páginas
  "total": 624,    // total de itens encontrados
  "questoes": [/* array de itens */]
}

Para percorrer todos os resultados, itere de page=1 até page=pages. Cada página consome 1 requisição no seu billing.

GET https://qapi.otunac.com/api/questoes?page=1&size=10&banca=FGV&ano=2024
Q-Api-Key: qb_SuaChaveAqui

{
  "page":  1,
  "size":  10,
  "pages": 63,
  "total": 624,
  "questoes": [
    {
      "_id":      "69a8224af6d9445ec04dad9c",
      "orgao":    "TJ/SE",
      "banca":    "FGV",
      "ano":      2023,
      "cargo":    "Analista Judiciário - Análise de Sistemas",
      "materia":  "Conhecimento Específico",
      "assunto":  "Arquitetura de Computadores",
      "enunciado":"Em sistemas operacionais, a métrica que mede...",
      "opcaoA":   "throughput;",
      "opcaoB":   "tempo de espera;",
      "opcaoC":   "tempo de turnaround;",
      "opcaoD":   "tempo de processador;",
      "opcaoE":   "utilização do processador.",
      "gabarito": "A",
      "comentario":"Throughput é o número de processos...",
      "texto":    "QTXT566467"  // código p/ buscar o texto em /api/texts/:codigo
    }
  ]
}

## cURL
curl -X GET \
  "https://qapi.otunac.com/api/questoes?banca=FGV&materia=Direito+Administrativo&page=1&size=20" \
  -H "Q-Api-Key: qb_SuaChaveAqui"

## Python
import requests

r = requests.get(
    "https://qapi.otunac.com/api/questoes",
    params={"banca": "FGV", "materia": "Direito Administrativo", "page": 1, "size": 20},
    headers={"Q-Api-Key": "qb_SuaChaveAqui"}
)
data = r.json()
print(f"Total: {data['total']} questões, {data['pages']} páginas")

## JavaScript
const params = new URLSearchParams({ banca: "FGV", materia: "Direito Administrativo", page: 1, size: 20 });
const r = await fetch(`https://qapi.otunac.com/api/questoes?${params}`, {
  headers: { "Q-Api-Key": "qb_SuaChaveAqui" }
});
const data = await r.json();

GET https://qapi.otunac.com/api/textos/QTXT566467
Q-Api-Key: qb_SuaChaveAqui

{
  "_id":       "69b0cfaa20dadd7d66bfcec9",
  "codigo":    "QTXT566467",
  "titulo":    "A reinvenção da vírgula",
  "texto":     "No começo de 1902, Machado de Assis...",
  "fonte":     "Machado de Assis",
  "createdAt": "2026-03-11T02:12:58.079Z"
}

## Python — buscar questão e carregar seu texto base
import requests

BASE    = "https://qapi.otunac.com/api"
headers = {"Q-Api-Key": "qb_SuaChaveAqui"}

questoes = requests.get(f"{BASE}/questoes", params={"banca": "FGV"}, headers=headers).json()

for q in questoes["questoes"]:
    if q["texto"]:  # campo não vazio → tem texto base
        txt = requests.get(f"{BASE}/textos/{q['texto']}", headers=headers).json()
        print(txt["titulo"], txt["texto"][:200])

GET https://qapi.otunac.com/api/provas?banca=CEBRASPE&ano=2024&page=1&size=10
Q-Api-Key: qb_SuaChaveAqui

{
  "provas": [
    {
      "_id":          "6a164c795e06528a230ff9d4",
      "orgao":         "Polícia Federal",
      "banca":         "CEBRASPE",
      "cargo":         "Delegado Federal",
      "ano":           2024,
      "linkProva":     "https://cdn.exemplo.com/prova.pdf",
      "linkGabarito":  "https://cdn.exemplo.com/gabarito.pdf",
      "createdAt":     "2025-05-30T14:00:00.000Z"
    }
  ],
  "total": 12,
  "page":  1,
  "size":  10,
  "pages": 2
}

GET https://qapi.otunac.com/api/provas/6a164c795e06528a230ff9d4
Q-Api-Key: qb_SuaChaveAqui

{
  "_id":          "6a164c795e06528a230ff9d4",
  "orgao":         "Polícia Federal",
  "banca":         "CEBRASPE",
  "cargo":         "Delegado Federal",
  "ano":           2024,
  "linkProva":     "https://cdn.exemplo.com/prova.pdf",
  "linkGabarito":  "https://cdn.exemplo.com/gabarito.pdf",
  "uploadProva":   { "filename": "pf_2024.pdf", "size": 2048576, "uploadedAt": "2025-05-30T14:00:00.000Z" },
  "uploadGabarito": { "filename": "gabarito_pf_2024.pdf", "size": 512000, "uploadedAt": "2025-05-30T15:00:00.000Z" },
  "createdAt":     "2025-05-30T14:00:00.000Z"
}

GET https://qapi.otunac.com/api/concursos?status=editais+publicados&ano=2026&page=1&size=10
Q-Api-Key: qb_SuaChaveAqui

{
  "concursos": [
    {
      "_id":            "6a582f98b7e102f6a66d0e16",
      "orgao":           "DATAPREV",
      "banca":           "FGV Conhecimento",
      "descricao":       "Informações sobre o concurso público...",
      "status":          "editais publicados",
      "vagas":           212,
      "cargos":          ["Engenharia", "Advocacia"],
      "requisitos":      "Nível superior",
      "remuneracao":     "até R$ 10.685,44",
      "taxaInscricao":   "110,00",
      "website":         "https://conhecimento.fgv.br/concursos/dataprev26",
      "inicioInscricao": "6 de julho de 2026 às 16h",
      "fimInscricao":    "6 de agosto de 2026 às 16h",
      "dataProva":       "11 de outubro de 2026",
      "horaProva":       null,
      "validade":        "2 anos (podendo ser prorrogado)",
      "ano":             2026,
      "createdAt":       "2026-07-16T01:10:48.150Z"
    }
  ],
  "total": 2,
  "page":  1,
  "size":  10,
  "pages": 1
}

GET https://qapi.otunac.com/api/concursos/6a582f98b7e102f6a66d0e16
Q-Api-Key: qb_SuaChaveAqui

Retorna a lista fixa de valores aceitos pelo campo status, na ordem do fluxo de um concurso — útil para popular um filtro na sua aplicação.

{
  "status": [
    "solicitado", "autorizado", "banca em definição",
    "banca contratada", "comissão formada", "previsto",
    "anunciado", "editais publicados"
  ]
}

GET https://qapi.otunac.com/api/simulados?banca=FGV&materia=Direito+Constitucional&size=20
Q-Api-Key: qb_SuaChaveAqui

{
  "questoes": [ /* array de questões, na ordem sorteada */ ],
  "total": 137,   // total de questões que batem com o filtro
  "size":  20    // quantidade efetivamente retornada
}

Todos os filtros são opcionais e combináveis — chame sem nenhum para sortear questões de toda a base.

Lista as bancas organizadoras. Use search para filtrar por nome.

GET https://qapi.otunac.com/api/bancas?page=1&size=10&search=fgv
Q-Api-Key: qb_SuaChaveAqui

{
  "bancas": ["FGV"],
  "total": 1, "page": 1, "pages": 1
}

Lista os órgãos. Use search para busca parcial.

GET https://qapi.otunac.com/api/orgaos?page=1&size=5&search=ces
Q-Api-Key: qb_SuaChaveAqui

{
  "orgaos": ["CESPE", "CESGRANRIO"],
  "total": 2, "page": 1, "pages": 1
}

Lista os cargos disponíveis na base.

GET https://qapi.otunac.com/api/cargos?page=1&size=10&search=professor
Q-Api-Key: qb_SuaChaveAqui

{
  "cargos": ["Professor de Ensino Básico", "Professor Adjunto"],
  "total": 2, "page": 1, "pages": 1
}

Lista as matérias e disciplinas disponíveis.

GET https://qapi.otunac.com/api/materias?page=1&size=5&search=Direito
Q-Api-Key: qb_SuaChaveAqui

{
  "materias": ["Direito Administrativo", "Direito Constitucional", "Direito Civil"],
  "total": 3, "page": 1, "pages": 1
}

Lista os assuntos de uma matéria. materia é obrigatório.

GET https://qapi.otunac.com/api/assuntos?materia=Tecnologia+Java&page=1&size=5&search=hibernate
Q-Api-Key: qb_SuaChaveAqui

{
  "materia": "Tecnologia Java",
  "assuntos": ["Hibernate / JPA", "Hibernate Cache"],
  "total": 2, "page": 1, "pages": 1
}

POST https://qapi.otunac.com/api/comentarios
Q-Api-Key: qb_SuaChaveAqui
Content-Type: application/json

{
  "questao":    "69a8224af6d9445ec04dad9c",
  "usuario":    "Maria Souza",
  "comentario": "O gabarito está incorreto, a alternativa correta é a B."
}

{
  "_id":        "6a539f2c790ad5b7852c63ad",
  "questao":    "69a8224af6d9445ec04dad9c",
  "usuario":    "Maria Souza",
  "comentario": "O gabarito está incorreto, a alternativa correta é a B.",
  "createdAt":  "2026-07-12T14:05:32.740Z",
  "updatedAt":  "2026-07-12T14:05:32.740Z"
}

Lista os comentários de uma questão, em ordem cronológica. Lista vazia se a questão ainda não tiver comentários.

GET https://qapi.otunac.com/api/comentarios?questao=69a8224af6d9445ec04dad9c
Q-Api-Key: qb_SuaChaveAqui

{
  "comentarios": [
    { "_id": "...", "usuario": "Maria Souza", "comentario": "O gabarito está incorreto...", "createdAt": "..." }
  ]
}

Atualiza usuario e/ou comentario. Retorna 404 se o ID não existir.

PUT https://qapi.otunac.com/api/comentarios/6a539f2c790ad5b7852c63ad
Q-Api-Key: qb_SuaChaveAqui
Content-Type: application/json

{ "comentario": "Editado: na verdade o gabarito está certo." }

Remove um comentário. Retorna 204 sem corpo. 404 se o ID não existir.

DELETE https://qapi.otunac.com/api/comentarios/6a539f2c790ad5b7852c63ad
Q-Api-Key: qb_SuaChaveAqui

POST https://qapi.otunac.com/api/suporte
Q-Api-Key: qb_SuaChaveAqui
Content-Type: application/json

{
  "incidente":     "Falha no endpoint /api/questoes",
  "descricao":     "Recebendo 500 ao filtrar por banca=FGV.",
  "nomeDoCliente": "João Silva",
  "email":         "[email protected]"
}

{
  "_id":           "6a539f3f790ad5b7852c63b8",
  "incidente":     "Falha no endpoint /api/questoes",
  "descricao":     "Recebendo 500 ao filtrar por banca=FGV.",
  "nomeDoCliente": "João Silva",
  "email":         "[email protected]",
  "createdAt":     "2026-07-12T14:05:51.772Z"
}

Apenas a abertura de chamados é exposta pela API pública — consulta, edição e remoção de chamados ficam restritas à equipe do QAPI.

Cria uma nova conta e retorna a api_key gerada automaticamente — prefixada com qb_.

POST https://qapi.otunac.com/api/auth/register
Content-Type: application/json

{
  "name":     "João Silva",
  "email":    "[email protected]",
  "cpf":      "123.456.789-09",
  "password": "minhasenha123"
}

{
  "message": "Conta criada com sucesso.",
  "api_key": "qb_abc123xyz..."   // guarde esta chave!
}

Autentica com e-mail e senha. Retorna um JWT Bearer token e os dados da conta, incluindo a api_key.

POST https://qapi.otunac.com/api/auth/login
Content-Type: application/json

{
  "email":    "[email protected]",
  "password": "minhasenha123"
}

{
  "token":          "eyJhbGci...",   // JWT — válido por 24h
  "api_key":        "qb_abc123xyz...",
  "api_key_active": true
}

O JWT retornado pode ser usado como Authorization: Bearer <token> em rotas autenticadas da web. Para acesso à API de questões, use sempre o Q-Api-Key header com sua api_key.

{
  "error": "Chave de API inválida ou inexistente."
}

import requests

r = requests.get(
    "https://qapi.otunac.com/api/questions",
    headers={"Q-Api-Key": "qb_SuaChave"}
)

if r.status_code == 200:
    data = r.json()
elif r.status_code == 401:
    raise ValueError("API Key inválida")
elif r.status_code == 403:
    raise PermissionError("Chave suspensa — regularize o pagamento")
else:
    r.raise_for_status()