Documentación de la API Mokapen

Códigos de error

Las APIs de Mokapen usan códigos HTTP estándar. Las respuestas de error son JSON con un mensaje descriptivo.

Códigos HTTP

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

Errores de autenticación

  • 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?