Errores
Códigos de estado, códigos de error y qué hacer en cada caso.
Todos los errores tienen la misma estructura:
{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "`kg` is invalid: Too small: expected number to be >=1.",
"param": "kg"
}
}param indica el campo de la solicitud que causó el error, si lo hay. Cada respuesta incluye un encabezado Request-Id: indíquelo cuando se comunique con el equipo de soporte.
| Estado | Código | ¿Reintentar? | Qué hacer |
|---|---|---|---|
| 400 | invalid_json |
No | Envíe un objeto JSON de 10 KB como máximo. |
| 400 | idempotency_key_missing / idempotency_key_invalid |
No | Envíe un encabezado Idempotency-Key válido. |
| 401 | invalid_api_key |
No | Revise la clave; es posible que se haya revocado. |
| 402 | insufficient_balance |
Después de una recarga | El error incluye balance_cents y required_cents. |
| 403 | api_access_inactive |
No | La cuenta no está aprobada o está suspendida. Comuníquese con el equipo de soporte. |
| 403 | insufficient_permissions |
No | Use una clave con acceso de compra. |
| 404 | resource_missing / not_found |
No | Revise el ID de la compensación o la ruta. |
| 409 | idempotency_key_reused |
No | Use una clave nueva para una compra nueva. |
| 422 | validation_error |
No | Corrija el campo indicado en param. |
| 422 | amount_too_small |
No | Con su tarifa, el monto equivale a menos de 1 kg. |
| 429 | rate_limited |
Sí | Espere los segundos que indica Retry-After. |
| 500 | api_error |
Sí | Vuelva a intentarlo con el mismo Idempotency-Key. |