Erros
Toda recusa tem o mesmo formato. Aja com base em code: ele nunca muda. message é para pessoas, e pode mudar.
O formato de um erro
{
"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"
}
}Informe o request_id se falar com o suporte. Toda resposta também o traz no cabeçalho Request-Id.
Todos os códigos
A API não entende a requisição: a mensagem diz o motivo. Corrija antes de enviar de novo.
POST /orders precisa de um cabeçalho Idempotency-Key válido: até 200 caracteres ASCII sem espaços.Uma linha da lista não é o que o verificador aceita. A mensagem mostra exemplos.
Este verificador precisa de mais entradas por arquivo.
A lista é longa demais: até 100.000 entradas em uma requisição, ou 10.000.000 em um upload.
O arquivo tem mais de 200 MB.
O
country que você enviou não corresponde aos números da lista.Um arquivo precisa ter números de um só país. Divida-o em um arquivo por país.
Esse
upload_id não é seu, o arquivo dele ainda não terminou de ser enviado ou o arquivo dele não existe mais (um upload aguarda um pedido por 24 horas). Se você já fez um pedido com este upload e perdeu a resposta, repita essa requisição com a chave de idempotência original. Caso contrário, envie o arquivo de novo e faça o pedido com uma nova chave de idempotência: nada foi feito com a anterior.O arquivo mudou depois de ter o preço calculado. Nenhum pedido foi feito. Envie-o de novo e faça o pedido com uma nova chave de idempotência.
O preço é antigo demais para ser usado. Repita a requisição com a mesma
Idempotency-Key.invalid_key
401A chave de API está ausente, errada ou não é nossa.
revoked_key
401Esta chave de API foi revogada. Use outra.
expired_key
401Esta chave de API expirou. Crie uma nova.
Seu saldo é insuficiente para este pedido. Recarregue e depois repita-o com a mesma chave de idempotência.
key_blocked
403Esta chave de API foi bloqueada. Fale com o suporte.
Esta chave de API está restrita a outros endereços IP.
Esta conta não pode usar a API. Fale com o suporte.
O acesso à API está desativado para esta conta. O site continua funcionando. Fale com o suporte.
Esta chave de API é somente leitura, e esta chamada precisa de uma chave que possa fazer pedidos.
Este verificador não está disponível para sua conta no momento. Veja
GET /checkers.Seu endereço IP foi bloqueado. Fale com o suporte.
not_found
404Esse pedido ou endpoint não existe nesta conta.
Esta chave de idempotência foi usada com uma requisição diferente. Use uma nova chave de idempotência para um novo pedido.
O preço não é o que você esperava, ou mudou desde o primeiro envio da chave de idempotência. Nenhum pedido foi feito. Use uma nova chave de idempotência para fazer o pedido pelo novo preço.
A requisição tem mais de 4 MB. Use
POST /uploads para uma lista grande.Você tem uploads demais aguardando (20 arquivos ou 100 MB), ou já fez uploads demais hoje (500). Faça um pedido com um deles ou tente mais tarde: um upload é removido depois de 24 horas.
rate_limited
429Você passou de um limite de requisições. Aguarde os segundos indicados em
Retry-After. Se for um pedido, repita-o com a mesma chave de idempotência. Veja Limites de requisições.Você tem pedidos não terminados demais. Aguarde os segundos indicados em
Retry-After e depois repita o pedido com a mesma chave de idempotência.Algo deu errado do nosso lado. Em
POST /orders, o pedido pode ter sido feito, então repita a requisição com a mesma Idempotency-Key: isso nunca cobra duas vezes. Em qualquer outra chamada, tente de novo ou fale com o suporte informando o request_id.api_disabled
503A API está desativada no momento. Tente mais tarde. Se for um pedido, repita-o com a mesma chave de idempotência.
A API não pode responder agora. Aguarde um minuto e repita a requisição com a mesma chave de idempotência.
Não conseguimos confirmar o pedido. Repita a requisição com a mesma
Idempotency-Key para saber o estado real: isso nunca cobra duas vezes. Se continuar respondendo isto por mais de alguns minutos, pare e fale com o suporte informando o request_id. Não crie uma nova chave de idempotência.