Empezar
Errores y límites
Cómo responde la API cuando algo falla y cuántas peticiones puedes hacer.
Si algo falla, la respuesta lleva un código HTTP de error y un cuerpo con un código fijo y una explicación en español:
{
"error": {
"code": "invalid_status",
"message": "Solo se puede marcar como enviado un pedido confirmado (in_progress)."
}
}| HTTP | Código | Cuándo |
|---|---|---|
| 400 | invalid_json | El cuerpo de la petición no es un JSON válido. |
| 400 | missing_parameter | Falta un dato obligatorio. |
| 400 | invalid_parameter | Un dato no tiene el formato o el valor admitido. |
| 401 | unauthenticated | No se ha enviado la clave. |
| 401 | invalid_key | La clave no existe, está revocada o la tienda ya no es de su dueño. |
| 403 | insufficient_scope | La clave no tiene el permiso necesario. |
| 403 | account_suspended | La cuenta de maker está suspendida. |
| 404 | not_found | La ruta no existe, o el pedido o el producto no es de tu tienda. |
| 405 | method_not_allowed | Esa ruta no admite ese método (GET, POST, PATCH). |
| 409 | invalid_status | El pedido no está en el estado necesario para esa acción. |
| 409 | confirm_deadline_passed | Ha pasado el plazo para confirmar el pedido. |
| 409 | not_approved | El producto aún no está aprobado por Primters. |
| 409 | shop_not_active | La tienda no está activa y no puede publicar productos. |
| 409 | price_calculated | El precio del producto depende de la cantidad o de las opciones y se cambia desde el panel. |
| 429 | rate_limited | Más de 120 peticiones en un minuto con la misma clave. |
| 500 | internal_error | Error de Primters. Reintenta pasados unos segundos. |
Límite de peticiones
Cada clave puede hacer hasta 120 peticiones por minuto. Las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining dicen cuántas te quedan y, si te pasas, Retry-After dice cuántos segundos esperar.
Ante un error 429 o 500, espera y reintenta. Ante uno 400, 401, 403, 404 o 409, reintentar no sirve: hay que corregir la petición.
¿Dudas o necesitas algo que no está? Escríbenos a contacto@primters.com indicando, si es un error, la petición que haces y la respuesta que recibes (sin la clave).
