IntegrationsReferência da API
Erros
Formato de resposta de erro, códigos de erro, limites e padrões de recuperação.
Esta página resume os formatos padrão de erro e os modos de falha comuns para integrações com a Carrot API.
Formato da resposta de erro
Payload típico de erro:
{
"statusCode": 400,
"errors": [
{
"code": "validationError",
"message": "Failed validating required field",
"id": "5g1XRgWZ0odA79dHJvcPP",
"timestamp": "1684766595"
}
]
}Códigos de erro
| HTTP | Código | Significado |
|---|---|---|
| 400 | invalidJson | O corpo da requisição não pôde ser decodificado como JSON. |
| 400 | validationError | O payload da requisição falhou na validação de schema. |
| 401 | unauthorized | Token de acesso ausente, inválido ou expirado. |
| 403 | restrictedResource | O token não tem permissão para este recurso ou ambiente. |
| 404 | objectNotFound | O recurso não existe ou não é compartilhado com o proprietário do token. |
| 409 | conflictError | A operação não pôde ser concluída devido a um conflito de dados. |
| 409 | PENDING_PROCESS_CONFLICT_ERROR | O documento solicitado ainda está sendo processado. Tente novamente mais tarde. |
| 429 | rateLimited | A taxa de requisições excedeu o limite permitido. |
| 500 | internalServerError | Falha inesperada no servidor. |
| 503 | serviceUnavailable | Serviço temporariamente indisponível ou requisição excedeu a janela de processamento. |
| 504 | gatewayTimeout | Timeout upstream/expiração de sessão ao completar a requisição. |
Para limites de taxa e cotas, consulte Limites de Taxa.
Para padrões de recuperação de erros e estratégias de retentativa, consulte Tratamento de Erros.