Passer au contenu principal
Envoyez votre clé d’API dans l’en-tête Authorization de chaque requête :
Les clés commencent par vt_. Une clé fonctionne dès sa création.

Obtenir une clé

  1. Inscrivez-vous sur querying.ai. Les nouveaux comptes démarrent avec 500 crédits gratuits.
  2. Ouvrez Clés d’API dans le tableau de bord et créez une clé.
  3. Copiez la clé lorsqu’elle s’affiche. Stockez-la dans une variable d’environnement ou un gestionnaire de secrets.
Un compte peut avoir jusqu’à 5 clés actives. Gardez une place pour un remplacement planifié, puis maintenez les deux clés actives pendant le changement des clients :
  1. Créez une clé supplémentaire dans le tableau de bord avec les moteurs autorisés, le plafond quotidien de crédits et la date d’expiration nécessaires.
  2. Mettez à jour tous les clients et la vérification des signatures de webhooks pour utiliser la nouvelle clé. Vérifiez que les requêtes aboutissent ; conservez l’ancienne clé de signature pour les notifications des tâches soumises avec celle-ci.
  3. Révoquez l’ancienne clé.
La rotation du tableau de bord émet une nouvelle clé avec les mêmes réglages et révoque immédiatement l’ancienne. Les requêtes utilisant l’ancienne clé renvoient alors 401 ; les clients doivent passer à la nouvelle clé pour reprendre.
N’utilisez la clé que depuis du code côté serveur. Quiconque détient la clé peut dépenser vos crédits. Ne l’intégrez pas dans une application web, une application mobile ou un dépôt public.

Réglages de la clé

Chaque clé dispose de réglages facultatifs, définis dans le tableau de bord : Consultez Crédits et limites pour les limites à l’échelle du compte.

Quels endpoints exigent une clé

Erreurs

Une clé absente, mal formée, révoquée ou expirée renvoie 401. Sur les endpoints de tâches, de lots et de recherche, le code est MISSING_API_KEY :
Les tâches qu’une clé a créées avant d’être révoquée ou d’expirer s’exécutent quand même et sont facturées, y compris les éléments d’un lot. Référence complète des erreurs : Erreurs.