Monitore o uso da sua chave antes de atingir um limite
Acompanhar seus cabeçalhos de cota ao longo do caminho mostra quando um limite está se aproximando, bem antes de uma requisição ser realmente rejeitada.
Teste sua integração sem gastar sua cota diária
Criar uma integração geralmente significa dezenas ou centenas de chamadas de teste antes que qualquer coisa chegue perto do tráfego de produção, e nenhum desses testes precisa usar um plano pago.
Testar sem nenhuma chave
2.500 requisições gratuitas por dia estão disponíveis a partir de qualquer endereço, sem necessidade de chave, o que basta para a maior parte do trabalho de integração: montar a formatação das requisições, verificar a leitura das respostas e percorrer o tratamento de erros com alguns casos de teste para cada um.
GET /v1/forward?q=Test Address, Test City&limit=1Sem cabeçalho X-API-Key, sem cabeçalho Authorization, nada além da própria requisição.
Acompanhar os cabeçalhos de cota durante os testes
Mesmo sem chave, toda resposta traz os mesmos cabeçalhos de cota, então você pode ver X-Quota-Used e X-Quota-Free-Remaining subirem e descerem exatamente como aconteceria em produção, o que é útil para testar como o seu próprio código lida com esses cabeçalhos antes que isso importe de verdade.
X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458Testar uma chave sem gastar crédito
Depois que você se cadastra e gera uma chave, essa chave também recebe as próprias 2.500 requisições gratuitas por dia, um espaço de testes separado que não mexe no crédito pré-pago nem conta contra um pacote Unlimited. Este é o momento de testar comportamentos específicos da chave, como as diferentes formas de enviá-la (cabeçalho, bearer token, basic auth ou parâmetro de consulta), tudo sem gastar nada.
Testando caminhos de erro de propósito
Envie uma requisição com um parâmetro inválido para ver um 400, ou uma chave propositalmente errada para ver um 401, para que o seu código de tratamento de erros tenha sido realmente exercitado antes do lançamento, em vez de apenas supor que ele funciona. Cada uma dessas chamadas de teste, bem-sucedida ou não, é uma requisição descontada da cota gratuita, algo que não deve preocupar você em volumes normais de teste.
Passando para o tráfego de produção
Quando o tráfego real começa, a mesma cota gratuita continua cobrindo o uso diário típico de muitas integrações menores, e o crédito pré-pago ou um pacote Unlimited só se torna necessário quando o volume passa de 2.500 requisições por dia.
Não é preciso um ambiente sandbox separado aqui, já que a cota gratuita já oferece um campo de testes completo com a API real. Comece gerando uma chave no painel, ou leia primeiro a documentação de autenticação se quiser ver os formatos de chave antes de se cadastrar.