Quick Start - EnemHub API

Crie sua conta

Cadastre-se em platform.enemhub.com.br. A conta é da organização, não da pessoa — as chaves, a assinatura e o consumo pertencem a ela, e você pode convidar o resto do time depois.

Assine um plano

Em Faturamento, escolha Pro, Business ou fale com a gente sobre o Enterprise.A assinatura precisa estar ativa antes de gerar a chave: sem ela, a criação da API Key é recusada com 403.

Gere uma API Key

Em API Keys, clique em criar, dê um nome (produção, local, o que for) e escolha o produto ENEM + Vestibulares.

A chave completa aparece uma única vez, no momento da criação. Guardamos só o hash — não há como recuperá-la depois. Copie e salve num cofre de segredos. Se perder, revogue e gere outra.

Ela tem esta cara:

ehub_vest_aZ3fK9pQ...

Faça a primeira chamada

Comece pelo catálogo de exames — é ele que te dá os examId para filtrar depois:

curl https://api.enemhub.com.br/v1/vestibulares/exams \
  -H "X-API-Key: ehub_vest_SUA_CHAVE"

const res = await fetch(
  "https://api.enemhub.com.br/v1/vestibulares/exams",
  { headers: { "X-API-Key": process.env.ENEMHUB_API_KEY } },
);

const { data } = await res.json();
console.log(data.map((e) => `${e.name} (${e.institution})`));

import os, requests

res = requests.get(
    "https://api.enemhub.com.br/v1/vestibulares/exams",
    headers={"X-API-Key": os.environ["ENEMHUB_API_KEY"]},
)
for exame in res.json()["data"]:
    print(exame["name"], "—", exame["institution"])

Resposta:

{
  "data": [
    { "id": "3b1e...", "name": "FUVEST 2023", "institution": "USP", "type": "vestibular" },
    { "id": "7c9a...", "name": "ENEM 2023", "institution": "INEP", "type": "enem" }
  ]
}

Com um id em mãos, puxe as questões daquele exame:

curl -G https://api.enemhub.com.br/v1/vestibulares/questions \
  -H "X-API-Key: ehub_vest_SUA_CHAVE" \
  -d examId=3b1e... \
  -d limit=1

E agora

Autenticação

Escopo das chaves, rotação e o que significa cada erro de auth.

Exemplos

Filtros, paginação e como lidar com 429.

SDKs

Trechos prontos em TypeScript, Python, PHP e cURL.

API Reference

Todas as rotas, com playground.

⌘I

​E agora

Autenticação

Exemplos

SDKs

API Reference

E agora