Desenvolvedores
Enviar um job pela API do cliente
Chaves, idempotência, limites e paginação de resultados.
Use uma chave com escopo
Use uma chave Live com escopo de envio para verificações em produção. Mantenha-a no seu servidor e atribua apenas os escopos de envio, leitura ou saldo de que você precisa. As chaves de teste simulam endereços de exemplo reservados, sem chamada a provedores nem uso de créditos.
O limite da chave Live considera os créditos debitados mais as reservas aceitas. Se o limite for atingido, um novo job é recusado sem criar reserva. Os créditos do espaço de trabalho são reservados à medida que as verificações são admitidas para processamento, seguindo as mesmas regras de débito e devolução do painel.
Novas tentativas seguras
Envie uma Idempotency-Key estável com cada job. Uma nova tentativa correspondente retorna o mesmo job. Use o ID do job retornado para consultar o estado e os resultados paginados. Uma chave repetida com um payload diferente é rejeitada.
Uma pausa operacional pode recusar temporariamente novos jobs de produção com HTTP 503 live_verification_unavailable e sem reserva de créditos. Tente novamente mais tarde com a mesma chave de idempotência. Isso é independente das permissões da chave de API, dos limites da chave e dos limites de taxa.