Formato de respuesta
Cada endpoint devuelve el mismo envelope JSON, así escribes un solo parser para toda la API.
El envelope#
success— booleano;trueen una respuesta 2xx.data— la carga útil (objeto, array o null).error— un mensaje legible, onullsi hay éxito.timestamp— hora del servidor en ISO 8601.meta— objeto opcional (paginación/uso), onull.
{
"success": true,
"data": {
"enterpriseNumber": "0403.170.701",
"status": "AC",
"denomination": "Anheuser-Busch InBev"
},
"error": null,
"timestamp": "2026-06-05T09:00:00.000Z",
"meta": null
}En caso de error#
success es false, data es null y error describe el problema. El código HTTP indica la categoría.
{
"success": false,
"data": null,
"error": "Enterprise not found",
"timestamp": "2026-06-05T09:00:00.000Z",
"meta": null
}ℹ️
Primero ramifica según el estado HTTP, luego lee error para el mensaje. Consulta Errores.