Errores
Todos los rechazos tienen la misma forma. Actúa según code: nunca cambia. message es para personas, y puede cambiar.
La forma de un error
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}Indica el request_id si contactas con soporte. Cada respuesta también lo lleva en el encabezado Request-Id.
Todos los códigos
La API no entiende la solicitud: el mensaje indica por qué. Corrígela antes de volver a enviarla.
POST /orders necesita un encabezado Idempotency-Key válido: hasta 200 caracteres ASCII sin espacios.Una línea de la lista no es lo que acepta el verificador. El mensaje muestra ejemplos.
Este verificador necesita más entradas por archivo.
La lista es demasiado larga: hasta 100.000 entradas en una solicitud, o 10.000.000 en una subida.
El archivo supera los 200 MB.
El
country que enviaste no coincide con los números de la lista.Un archivo debe contener números de un solo país. Divídelo en un archivo por país.
Ese
upload_id no es tuyo, su archivo no ha terminado de subirse o su archivo ya no está (una subida espera un pedido durante 24 horas). Si ya hiciste un pedido con esta subida y perdiste la respuesta, repite esa solicitud con su clave de idempotencia original. De lo contrario, sube el archivo otra vez y realiza el pedido con una clave de idempotencia nueva: con la anterior no se realizó ningún pedido.El archivo cambió después de calcular el precio. No se realizó ningún pedido. Súbelo otra vez y realiza el pedido con una clave de idempotencia nueva.
El precio es demasiado antiguo para usarlo. Repite la solicitud con la misma
Idempotency-Key.invalid_key
401La clave de API falta, es incorrecta o no es una de las nuestras.
revoked_key
401Esta clave de API se ha revocado. Usa otra.
expired_key
401Esta clave de API ha caducado. Crea una nueva.
Tu saldo es insuficiente para este pedido. Recarga y luego repítelo con la misma clave de idempotencia.
key_blocked
403Esta clave de API se ha bloqueado. Contacta con soporte.
Esta clave de API está limitada a otras direcciones IP.
Esta cuenta no puede usar la API. Contacta con soporte.
El acceso a la API está desactivado para esta cuenta. El sitio web sigue funcionando. Contacta con soporte.
Esta clave de API es de solo lectura, y esta llamada necesita una clave que pueda realizar pedidos.
Este verificador no está disponible para tu cuenta en este momento. Consulta
GET /checkers.Tu dirección IP se ha bloqueado. Contacta con soporte.
not_found
404No existe ese pedido o endpoint en esta cuenta.
Esta clave de idempotencia se usó con una solicitud diferente. Usa una clave de idempotencia nueva para un pedido nuevo.
El precio no es el que esperabas, o ha cambiado desde que se envió la clave de idempotencia por primera vez. No se realizó ningún pedido. Usa una clave de idempotencia nueva para realizar el pedido al precio nuevo.
La solicitud supera los 4 MB. Usa
POST /uploads para una lista grande.Tienes demasiadas subidas en espera (20 archivos o 100 MB), o has hecho demasiadas hoy (500). Realiza un pedido con una de ellas o inténtalo más tarde: una subida se elimina a las 24 horas.
rate_limited
429Has superado un límite de frecuencia. Espera los segundos indicados en
Retry-After. Si es un pedido, repítelo con la misma clave de idempotencia. Consulta Límites de frecuencia.Tienes demasiados pedidos sin terminar. Espera los segundos indicados en
Retry-After y luego repite el pedido con la misma clave de idempotencia.Algo ha fallado de nuestro lado. En
POST /orders el pedido puede haberse realizado, así que repite la solicitud con la misma Idempotency-Key: nunca cobra dos veces. En cualquier otra llamada, inténtalo de nuevo o contacta con soporte indicando el request_id.api_disabled
503La API está desactivada por ahora. Inténtalo más tarde. Si es un pedido, repítelo con la misma clave de idempotencia.
La API no puede responder en este momento. Espera un minuto y repite la solicitud con la misma clave de idempotencia.
No pudimos confirmar el pedido. Repite la solicitud con la misma
Idempotency-Key para conocer su estado real: nunca cobra dos veces. Si sigue respondiendo esto durante más de unos minutos, detente y contacta con soporte indicando el request_id. No crees una clave de idempotencia nueva.