Errores

Catálogo de errores

La API de eFirma utiliza códigos de respuesta HTTP convencionales para indicar cuando una solicitud a la API ha sido exitosa o ha fallado.

Rango	Significado
`2xx`	La solicitud fue exitosa
`4xx`	Ocurrió un problema con la solicitud por la información dada (parámetro inválido, fondos insuficientes, etc.)
`5xx`	Ocurrió un problema con los servidores de eFirma

Código	Nombre	Descripción
400	Bad Request	La solicitud no fue aceptada, regularmente debido a la falta de parámetros obligatorios
401	Unauthorized	La autenticación para la validación de las credenciales ha fallado o las llaves son inválidas
402	Request Failed	Los parámetros fueron aceptados, pero ocurrió un error al procesar la solicitud
404	Not Found	El objeto solicitado no existe, esto puede ocurrir en solicitudes del tipo `GET` o `DELETE`
405	Method Not Allowed	El método HTTP (`GET`, `PUT`, `POST`, `DELETE`) no es válido para la URI solicitada
500	Internal Server Error	Ha ocurrido un error por parte de nuestros servidores
504	Gateway Timeout	Nuestro servidor intentó conectarse a los OCSP para la validación de certificados, pero no recibió respuesta del OCSP

Causa común

Falta de parámetros obligatorios en la solicitud.

json

{
    "status": "error",
    "message": "Missing required parameter: email"
}

Causa común

Credenciales de autenticación inválidas o expiradas.

json

{
    "status": "error",
    "message": "Invalid authentication credentials"
}

Causa común

El recurso solicitado no existe o ha sido eliminado.

json

{
    "status": "error",
    "message": "Document not found"
}

Causa común

Error interno del servidor. Si persiste, contacte a soporte.

json

{
    "status": "error",
    "message": "Internal server error"
}

Manejo de errores