> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enemhub.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Da criação da conta à primeira questão do ENEM na tela.

<Steps>
  <Step title="Crie sua conta">
    Cadastre-se em [platform.enemhub.com.br](https://platform.enemhub.com.br/sign-up).
    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.
  </Step>

  <Step title="Assine o plano Starter">
    Em [Faturamento](https://platform.enemhub.com.br/dashboard/billing), 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`.
  </Step>

  <Step title="Gere uma API Key">
    Em [API Keys](https://platform.enemhub.com.br/dashboard/keys), clique em
    criar, dê um nome (`produção`, `local`, o que for) e escolha o produto
    **ENEM**.

    <Warning>
      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.
    </Warning>

    Ela tem esta cara:

    ```
    ehub_enem_aZ3fK9pQ...
    ```
  </Step>

  <Step title="Faça a primeira chamada">
    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.enemhub.com.br/v1/enem/questions?limit=1 \
        -H "X-API-Key: ehub_enem_SUA_CHAVE"
      ```

      ```js TypeScript theme={null}
      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");
      ```

      ```python Python theme={null}
      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")
      ```
    </CodeGroup>

    Resposta:

    ```json theme={null}
    {
      "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 }
    }
    ```
  </Step>
</Steps>

## E agora

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/enem/autenticacao">
    Escopo das chaves, rotação e o que significa cada erro de auth.
  </Card>

  <Card title="Exemplos" icon="code" href="/enem/exemplos">
    Filtros, paginação e como lidar com `429`.
  </Card>

  <Card title="SDKs" icon="cube" href="/enem/sdks">
    Trechos prontos em TypeScript, Python, PHP e cURL.
  </Card>

  <Card title="API Reference" icon="terminal" href="/enem/api-reference">
    Todas as rotas, com playground.
  </Card>
</CardGroup>