RFC 9457 Problem Details

Referencia de Errores de la API

Todos los errores de la API de Mind One siguen el formato RFC 9457 Problem Details. Cada respuesta de error incluye una URI type que enlaza directamente a esta documentación.

Estructura de la Respuesta

{
  "type":     "https://docs.getmindapp.io/api/errors/not-found",  // URI que identifica el tipo de error
  "title":    "Resource Not Found",                              // Título legible por humanos
  "status":   404,                                               // Código de estado HTTP
  "detail":   "Workspace with id 'abc-123' not found",           // Mensaje de error específico
  "instance": "/api/v1/public/workspaces/abc-123"             // Ruta de la solicitud que causó el error
}

Tipos de Error

400
Bad Request
bad-request
Campos faltantes o inválidos en el cuerpo de la solicitud o en los parámetros de consulta.
401
Unauthorized
unauthorized
API Key faltante o inválida en el encabezado Authorization.
403
Forbidden
forbidden
La API Key es válida pero la cuenta no tiene permisos — límite del plan o suspensión.
404
Not Found
not-found
El recurso solicitado no existe o pertenece a otro tenant.
409
Conflict
conflict
Se violó una restricción de unicidad, por ejemplo, una clave duplicada en listas de valores.
422
Unprocessable Entity
unprocessable-entity
La solicitud es sintácticamente válida pero semánticamente incorrecta.
429
Too Many Requests
too-many-requests
Límite de tasa excedido. Implementa backoff exponencial y reintenta.
500
Internal Server Error
internal-server-error
Un error inesperado del servidor. Reintenta después de una breve espera.
4xx
Unknown
unknown
Un error HTTP que no corresponde a un tipo de error conocido.

Acerca de Problem Details (RFC 9457)

El Content-Type de todas las respuestas de error es application/problem+json. El campo type es una URI estable como identificador — al hacer clic te lleva a esta documentación. Este formato reemplaza los objetos de error ad-hoc con una estructura estándar y legible por máquinas.

← Volver a la Referencia de la API