Manejo de errores

Todas las respuestas de la API de Socios utilizan un formato de envolvente consistente.

Envolvente de respuesta

{
  "success": true,
  "message": "...",
  "data": {}
}

{
  "success": false,
  "message": "Error description",
  "errorCode": "ERROR_CODE"
}

Campo	Tipo	Descripción
`success`	boolean	`true` para éxito, `false` para error
`message`	string	Descripción del estado o error legible por humanos
`data`	object	Payload de respuesta en caso de éxito
`errorCode`	string	Código de error legible por máquina (presente en caso de error)

Estado	Significado
`200`	La solicitud fue exitosa
`400`	Solicitud incorrecta — parámetros inválidos o faltantes
`401`	No autorizado — token faltante, expirado o inválido
`404`	Recurso no encontrado (p. ej., el ID de rastreo no existe)
`500`	Error interno del servidor