Saltar para o conteúdo principal
Envie sua chave de API no cabeçalho Authorization de cada requisição:
As chaves começam com vt_. Uma chave funciona assim que é criada.

Obtenha uma chave

  1. Cadastre-se em querying.ai. Contas novas começam com 500 créditos grátis.
  2. Abra Chaves de API no painel e crie uma chave.
  3. Copie a chave quando ela for exibida. Guarde-a em uma variável de ambiente ou em um gerenciador de segredos.
Uma conta pode ter até 5 chaves ativas. Reserve uma vaga para uma substituição planejada e mantenha as duas chaves ativas durante a troca nos clientes:
  1. Crie uma chave adicional no painel com o escopo de mecanismos, o limite diário de créditos e a validade necessários.
  2. Atualize todos os clientes e a verificação de assinaturas de webhooks para usar a nova chave. Confirme que as requisições funcionam; mantenha a chave de assinatura antiga para entregas de tarefas enviadas com ela.
  3. Revogue a chave antiga.
A rotação no painel emite uma nova chave com as mesmas configurações e revoga a antiga imediatamente. As requisições com a chave antiga passam a retornar 401; os clientes precisam mudar para a nova chave para retomá-las.
Use a chave apenas em código do lado do servidor. Quem tiver a chave pode gastar seus créditos. Não a inclua em um app de navegador, em um app móvel nem em um repositório público.

Configurações da chave

Cada chave tem configurações opcionais, definidas no painel: Veja Créditos e limites para os limites da conta como um todo.

Quais endpoints exigem uma chave

Erros

Uma chave ausente, malformada, revogada ou expirada retorna 401. Nos endpoints de tarefas, lotes e pesquisa, o código é MISSING_API_KEY:
As tarefas que uma chave criou antes de ser revogada ou expirar continuam executando e são cobradas, incluindo os itens de um lote. Referência completa de erros: Erros.