As APIs do Mokapen usam códigos HTTP padrão. As respostas de erro são JSON com uma mensagem descritiva.
| Código | Significado | Causas comuns |
|---|---|---|
| 400 | Bad Request | Parâmetros da requisição inválidos ou ausentes |
| 401 | Unauthorized | Bearer token ausente ou inválido |
| 403 | Forbidden | Scope ou papel insuficiente, ou token não autorizado para esta organização |
| 404 | Not Found | Recurso ou endpoint inexistente |
| 429 | Too Many Requests | Throttling por minuto ultrapassado ou cota diária atingida |
| 500 | Internal Server Error | Erro inesperado no servidor — tente de novo com backoff |
Unauthenticated: No Token Provided — header Authorization: Bearer não enviado.Invalid Token — token malformado, expirado ou revogado.This token is not authorized for this organization. — {org_id} na URL não coincide com a organização do token.Missing required scopes — o token não inclui o scope exigido pelo endpoint.Preciso de ajuda?