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 o plano Starter

Em Faturamento, escolha o plano Starter do produto ENEM e conclua o checkout.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.

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_enem_aZ3fK9pQ...

Faça a primeira chamada

curl https://api.enemhub.com.br/v1/enem/questions?limit=1 \
  -H "X-API-Key: ehub_enem_SUA_CHAVE"

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

const { data, meta } = await res.json();
console.log(meta.total, "questões disponíveis");

import os, requests

res = requests.get(
    "https://api.enemhub.com.br/v1/enem/questions",
    headers={"X-API-Key": os.environ["ENEMHUB_API_KEY"]},
    params={"limit": 1},
)
print(res.json()["meta"]["total"], "questões disponíveis")

Resposta:

{
  "data": [
    {
      "id": "9f3c1a2e-...",
      "year": 2023,
      "difficulty": "medium",
      "statement": "...",
      "correctAlternative": "C",
      "exam": { "id": "...", "name": "ENEM 2023", "institution": "INEP" },
      "subject": { "id": "...", "name": "Matemática", "area": "Matemática e suas Tecnologias" },
      "alternatives": [ /* ... */ ]
    }
  ],
  "meta": { "page": 1, "limit": 1, "total": 4821 }
}

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