API Docs v1.0
Errores
Códigos de error de la API y cómo manejarlos.
Formato de error
Todos los errores siguen el mismo formato: ``json
{
"error": {
"code": "ERROR_CODE",
"message": "Descripción legible del error"
}
}
`
Códigos HTTP
Status Significado 200 OK — Request exitoso 400 Bad Request — Parámetros inválidos 401 Unauthorized — API key inválida o ausente 403 Forbidden — Sin permisos (scope insuficiente o IP bloqueada) 404 Not Found — Recurso no encontrado 409 Conflict — Conflicto (ej: factura ya anulada) 429 Too Many Requests — Rate limit excedido 500 Server Error — Error interno
Códigos de error comunes
Código HTTP Descripción UNAUTHORIZED 401 API key no proporcionada o inválida KEY_EXPIRED 401 La API key ha expirado INSUFFICIENT_SCOPE 403 La key no tiene el scope necesario IP_NOT_ALLOWED 403 Request desde IP no autorizada RATE_LIMIT_EXCEEDED 429 Excediste el límite de requests INVALID_PARAMS 400 Parámetros del request inválidos RESOURCE_NOT_FOUND 404 El recurso solicitado no existe INVOICE_ALREADY_VOIDED 409 La factura ya fue anulada VOID_NOT_SAME_DAY 400 Solo se pueden anular facturas del mismo día
Manejo recomendado
`javascript
try {
const response = await fetch('https://vertex.app/api/v1/invoices', {
headers: { 'Authorization': 'Bearer vtx_tu_key' }
})
if (!response.ok) {
const { error } = await response.json()
console.error(Error ${response.status}: ${error.code} - ${error.message})
if (response.status === 429) {
const retryAfter = response.headers.get('Retry-After')
// Esperar y reintentar
}
}
} catch (err) {
// Error de red
}
``