Fundamentos
Erros
Formato dos erros (RFC 9457) e os tipos mais comuns.
Os erros seguem a RFC 9457 (application/problem+json). O campo type identifica o erro; errors lista os campos com problema.
{
"type": "https://docs.pineplechain.com/problems/validation-error",
"title": "Validation error",
"status": 422,
"detail": "amount: must be at least 0.001",
"instance": "/v1/invoices",
"request_id": "req_6c1d0b7e-2f4a-4c3e-9d1b-7a5e8f2c4b10",
"errors": [{ "path": "amount", "message": "must be at least 0.001" }]
}Tipos comuns
| Status | type | Quando acontece |
|---|---|---|
| 400 | bad-request, malformed-json | Corpo inválido ou falta Idempotency-Key onde é obrigatória. |
| 401 | unauthorized | Chave ausente, inválida ou revogada. |
| 402 | fees-overdue | Fatura de taxas vencida (produção). |
| 403 | forbidden, kyb-required | Sem permissão, ou empresa ainda sem verificação aprovada. |
| 404 | not-found | Não existe, ou pertence a outra empresa. |
| 409 | invalid-state-transition, escrow-expired, mode-mismatch | A ação não vale no status atual, o escrow venceu, ou a chave é de outro ambiente. |
| 422 | validation-error, idempotency-key-reused | Campo inválido ou desconhecido, ou chave de idempotência reaproveitada. |
| 429 | rate-limited | Passou de 120 chamadas por minuto. |
| 502 / 503 | ledger-error, platform-not-ready | Falha temporária na XRPL ou na plataforma. Tente de novo. |
Campos desconhecidos no corpo ou na URL são recusados com 422. Isso pega erro de digitação cedo.