Desarrolladores

Enviar un trabajo de API de cliente

Claves, idempotencia, límites y paginación de resultados.

Usa una clave con ámbitos limitados

Usa una clave Live con el ámbito submit para la verificación en producción. Guárdala en tu servidor y asigna solo los ámbitos submit, read o balance que necesites. Las claves Test simulan direcciones de ejemplo reservadas sin llamadas al proveedor ni uso de créditos.

El límite de la clave live tiene en cuenta los créditos descontados más las reservas aceptadas. Si se alcanza el límite, se rechaza el nuevo trabajo sin crear una retención. Los créditos del espacio de trabajo se reservan a medida que las verificaciones se admiten para su procesamiento, con las mismas reglas de consumo y devolución que en el panel.

Reintentos seguros

Envía una Idempotency-Key estable con cada trabajo. Un reintento coincidente devuelve el mismo trabajo. Usa el ID de trabajo devuelto para consultar el estado y los resultados paginados. Se rechaza una clave repetida con un contenido distinto.

Una pausa operativa puede rechazar temporalmente nuevos trabajos en vivo con HTTP 503 live_verification_unavailable y sin retención de créditos. Vuelve a intentarlo más tarde con la misma clave de idempotencia. Esto es independiente de los permisos de la clave de API, los límites de la clave y los límites de frecuencia.

¿Sigues necesitando ayuda?

Inicia sesión para abrir un ticket de soporte privado.

Contactar con soporte