Saltar al contenido principal
Para ayudar a los socios a diagnosticar y resolver problemas rápidamente, todas las APIs devuelven una respuesta de error estructurada. Este modelo es consistente en todos los endpoints e incluye suficiente contexto para depuración, sin exponer detalles internos. Cada respuesta de error sigue el mismo formato básico: 
{
  "code": "<error_code>",
  "title": "<error_title>",
  "message": "<error_message>"
}

​
Definiciones de campos

  • code: Un identificador único y estable para el error.
  • title: Un resumen breve de lo que salió mal.
  • message: Un mensaje legible para humanos que explica cómo solucionarlo.
Usa siempre el campo code para identificar errores programáticamente. Los títulos y mensajes pueden evolucionar para mejorar la claridad.

​
Errores de validación a nivel de campo

Cuando un problema está relacionado con campos específicos en la carga útil de la solicitud, la respuesta incluye un objeto fields con información más granular.

​
Ejemplos

{
  "code": "IDE-0009",
  "title": "Missing Fields in Request",
  "message": "Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.",
  "fields": {
    "document": "document is a required field"
  }
}