API
Erros
Formato dos erros (problem+json) e os códigos mais comuns.
Erros vêm com o status HTTP certo e corpo no formato RFC 9457 (application/problem+json). Use o campo code: ele não muda. O title é texto para gente e pode mudar.
{
"type": "https://docs.rivoo.gg/api/erros#validation_failed",
"title": "Dados inválidos",
"status": 422,
"code": "validation_failed",
"errors": [{ "field": "items.0.quantity", "code": "min", "message": "quantity must not be less than 1" }],
"requestId": "req_mhexample0000request0001"
}Mande o requestId ao suporte quando precisar de ajuda com uma chamada.
Códigos comuns
| Status | code | Quando |
|---|---|---|
| 400 | bad_request | JSON malformado ou parâmetro inválido. |
| 401 | unauthenticated / invalid_api_key | Sem chave, ou chave inválida. Veja Autenticação. |
| 403 | permission_denied | A chave não pode fazer isso. |
| 404 | route_not_found | Caminho ou método que não existe. |
| 404 | *_not_found | O recurso não existe nesta loja (ex.: order_not_found). |
| 409 | idempotency_in_progress | A mesma Idempotency-Key ainda está sendo processada. Tente de novo em instantes. |
| 413 | payload_too_large | Corpo acima de 1 MB. |
| 422 | validation_failed | Campos inválidos: veja errors[], um item por campo. |
| 422 | idempotency_key_reused | A mesma Idempotency-Key com outro corpo. Veja Idempotência. |
| 429 | rate_limited | Passou do limite. Espere o Retry-After. Veja Limites. |
| 500 | internal_error | Falha nossa. Tente de novo com a mesma Idempotency-Key. |
Cada operação da referência lista, em Respostas, os códigos que pode devolver, com um exemplo de corpo por código. Os de Criar pedido estão explicados em Pedidos.