ERROS
Erros e correlação
Como decidir retry, localizar uma requisição e evitar tratamento por texto.
Envelope
Exemplo
{"contract":"print_sta_api_error_v1","code":"PRINT_STA_JOB_IDEMPOTENCY_CONFLICT","message":"...","status":409,"retryable":false,"request_id":"req_...","correlation_id":"cor_..."}Faça lógica pelo campo code, não por message. Preserve IDs em log.
| HTTP | Significado |
|---|---|
| 400 | Entrada inválida |
| 401 | Credencial |
| 402 | Plano/uso |
| 403 | Scope/ambiente |
| 404 | Não encontrado |
| 409 | Conflito de estado/idempotência |
| 413 | Payload grande |
| 415 | Content-Type |
| 429 | Rate limit |
| 503 | Serviço/política |
Você pode enviar X-Correlation-Id de 8–128 caracteres para seguir seu pedido em todo o fluxo.
Consulte também o OpenAPI 3.1.0 v1, com schemas tipados e exemplos.
Referência completa