Las APIs de Mokapen usan códigos HTTP estándar. Las respuestas de error son JSON con un mensaje descriptivo.
| Código | Significado | Causas comunes |
|---|---|---|
| 400 | Bad Request | Parámetros de la solicitud inválidos o faltantes |
| 401 | Unauthorized | Bearer token ausente o inválido |
| 403 | Forbidden | Scope o rol insuficiente, o token no autorizado para esta organización |
| 404 | Not Found | Recurso o endpoint inexistente |
| 429 | Too Many Requests | Throttling por minuto superado o cuota diaria alcanzada |
| 500 | Internal Server Error | Error inesperado del servidor — reintenta con backoff |
Unauthenticated: No Token Provided — no se envió el header Authorization: Bearer.Invalid Token — token malformado, vencido o revocado.This token is not authorized for this organization. — el {org_id} en la URL no coincide con la organización del token.Missing required scopes — el token no incluye el scope que exige el endpoint.¿Necesitas ayuda?