Erros e respostas

Códigos de resposta

Código	Significado	O que fazer
`200`	Sucesso	—
`401`	Não autenticado	Confira se o header se chama exatamente `API-KEY`
`404`	Recurso não encontrado	Confirme que está usando o ID público encriptado retornado pela API, não o código numérico interno

Estrutura das respostas de sucesso

Listagens retornam um array em data + paginação em meta:

{ "data": [ ... ], "meta": { "current_page": 1, "total": 100 } }

Detalhes (/recurso/{id}) retornam o objeto direto em data:

{ "data": { "id": "epz7Z...", ... } }

Dicas de tratamento

Trate 401 como erro de configuração (chave/ambiente) — repetir a chamada não resolve. Alerte e interrompa.
Trate 404 como dado inexistente ou ID incorreto — valide a origem do ID antes de retentar.
Sempre envie o header Accept: application/json.

📘
Recebendo 401 mesmo com a chave certa? Verifique se não está usando uma chave de desenvolvimento contra a URL de produção (ou vice-versa). Veja Ambientes.