Error Handling - Verifica API Documentation

Overview

La API de Verifica utiliza los códigos de estado HTTP estándar para indicar el resultado de cada solicitud. Cuando ocurre un error, la respuesta sigue un formato consistente con los campos type, status, message y errors.

Estructura del Error

type

string

Identificador del tipo de error (ej: “unauthorized”)

status

integer

Código de estado HTTP del error (ej: 401)

message

string

Descripción legible del error

errors

object | null

Detalle adicional de los errores cuando aplica (ej: errores de validación por campo). Es null si no hay detalle.

Códigos de Error

Código	Descripción
`400`	Solicitud inválida — parámetros faltantes o con formato incorrecto
`401`	Token de autenticación inválido o faltante
`422`	Error de validación — uno o más campos requeridos no son válidos
`429`	Demasiadas solicitudes — se ha excedido el límite de rate
`500`	Error interno del servidor

Ejemplo de Respuesta de Error

{
  "type": "unauthorized",
  "status": 401,
  "message": "Necesitas un API Key válido para realizar una solicitud correctamente.",
  "errors": null
}

Recomendaciones

4xx: revisa tu solicitud (autenticación, parámetros y formato) antes de reintentar.
429: aplica reintentos con backoff exponencial. Consulta la guía de Entendiendo la Quota.
500: reintenta más tarde. Si el problema persiste, escríbenos a [email protected].

​Overview

​Estructura del Error

​Códigos de Error

​Ejemplo de Respuesta de Error

​Recomendaciones

Overview

Estructura del Error

Códigos de Error

Ejemplo de Respuesta de Error

Recomendaciones