Zum Hauptinhalt springen
Senden Sie Ihren API-Schlüssel bei jeder Anfrage im Header Authorization:
Schlüssel beginnen mit vt_. Ein Schlüssel funktioniert, sobald er erstellt ist.

Einen Schlüssel erhalten

  1. Registrieren Sie sich auf querying.ai. Neue Konten starten mit 500 kostenlosen Credits.
  2. Öffnen Sie im Dashboard die Seite API-Schlüssel und erstellen Sie einen Schlüssel.
  3. Kopieren Sie den Schlüssel, wenn er angezeigt wird. Speichern Sie ihn in einer Umgebungsvariablen oder einem Secrets-Manager.
Ein Konto kann bis zu 5 aktive Schlüssel haben. Halten Sie für einen geplanten Austausch einen Platz frei und lassen Sie während der Client-Umstellung beide Schlüssel aktiv:
  1. Erstellen Sie im Dashboard einen zusätzlichen Schlüssel mit den benötigten Engines, dem täglichen Credit-Limit und dem Ablaufdatum.
  2. Stellen Sie alle Clients und die Prüfung der Webhook-Signaturen auf den neuen Schlüssel um. Prüfen Sie, ob Anfragen erfolgreich sind; behalten Sie den alten Signaturschlüssel für Zustellungen von damit eingereichten Tasks.
  3. Widerrufen Sie den alten Schlüssel.
Die Rotation im Dashboard erstellt einen neuen Schlüssel mit denselben Einstellungen und widerruft den alten sofort. Anfragen mit dem alten Schlüssel erhalten danach 401; Clients müssen zum Fortfahren auf den neuen Schlüssel wechseln.
Verwenden Sie den Schlüssel nur in serverseitigem Code. Wer den Schlüssel besitzt, kann Ihre Credits ausgeben. Liefern Sie ihn nicht in einer Browser-App, einer mobilen App oder einem öffentlichen Repository aus.

Schlüsseleinstellungen

Jeder Schlüssel hat optionale Einstellungen, die Sie im Dashboard festlegen: Kontoweite Limits finden Sie unter Credits und Limits.

Welche Endpunkte einen Schlüssel erfordern

Fehler

Ein fehlender, fehlerhafter, widerrufener oder abgelaufener Schlüssel liefert 401. Auf Task-, Batch- und Research-Endpunkten lautet der Code MISSING_API_KEY:
Tasks, die ein Schlüssel erstellt hat, bevor er widerrufen wurde oder abgelaufen ist, laufen weiter und werden berechnet, auch die Einträge eines Batches. Vollständige Fehlerreferenz: Fehler.