Ihren solvethree-API-Schlüssel erstellen und verwenden

1. 1.

   API-Schlüssel öffnen

   Öffnen Sie in der Konsole im vorgesehenen Workspace die API-Schlüssel unter /api-keys.

2. 2.

   Schlüssel benennen

   Wählen Sie „API-Schlüssel erstellen“. Geben Sie unter „Schlüsselname“ einen Namen ein, an dem Sie den Verwendungszweck erkennen, und wählen Sie dann „Schlüssel erstellen“.

3. 3.

   Vollständigen geheimen Schlüssel kopieren

   Kopieren Sie unter „API-Schlüssel speichern“ den geheimen Schlüssel und bewahren Sie ihn sicher für Ihre Serveranwendung auf. Er wird nur einmal angezeigt.

4. 4.

   Dialog schließen

   Wählen Sie „Ich habe diesen Schlüssel gespeichert“ erst, nachdem Sie den geheimen Schlüssel gespeichert haben.

Authentifizieren Sie Anfragen mit Authorization: Bearer, gefolgt vom vollständigen Workspace-Schlüssel. Halten Sie ihn aus browserseitigem Code heraus.

Setzen Sie für das folgende Beispiel in der Serverumgebung SOLVETHREE_API_KEY auf Ihren geheimen Schlüssel und SOLVETHREE_PROXY auf Ihre Proxy-URL. Ersetzen Sie accounts.example.com und login durch den Hostnamen und die Aktion Ihres Ziels. Für die Zielwebsite muss bereits ein aktives Profil verfügbar sein, auf das dieser Workspace zugreifen kann; das Senden ihres Hostnamens erstellt keines. Lesen Sie die Einrichtung von Website-Profilen, wenn Sie es noch nicht konfiguriert haben.

# Set SOLVETHREE_API_KEY and SOLVETHREE_PROXY in your environment first.
# Replace the hostname and action with your active site profile.
jq -n \
  --arg proxy "$SOLVETHREE_PROXY" \
  --arg requestId "login-$(date +%s)-$$" \
  '{site:"accounts.example.com", action:"login", proxy:$proxy, requestId:$requestId}' \
| curl --fail-with-body --max-time 30 \
  'https://api.solvethree.com/v1/tasks?waitMs=15000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @-

Dies sendet eine Anfrage zur Task-Erstellung an die öffentliche API. Dabei wird eine echte Lösung angefordert, nicht nur die Authentifizierung geprüft: Ein Task mit dem Status ready wird berechnet. Eine erfolgreiche HTTP-Antwort allein bedeutet weder, dass der Task den Status ready hat, noch, dass die Zielwebsite seine Lösung akzeptiert.

Die API gibt HTTP 401 zurück.

Prüfen Sie den Authorization-Header des Servers. Er muss Bearer gefolgt vom vollständigen geheimen Schlüssel enthalten, nicht den Schlüsselnamen oder ein angezeigtes Präfix. Prüfen Sie, ob der Schlüssel widerrufen wurde.

Probiere Folgendes: Korrigieren Sie den Header oder ersetzen Sie den widerrufenen Schlüssel und aktualisieren Sie Ihre Serverkonfiguration. Behandeln Sie die nicht erfolgreiche HTTP-Antwort, bevor Sie versuchen, Task-Daten auszulesen.

Der Schlüssel authentifiziert erfolgreich, aber das vorgesehene Website-Profil ist nicht verfügbar.

Prüfen Sie, zu welchem Workspace der Schlüssel gehört und ob dieser Workspace ein aktives Profil für die Zielwebsite hat. Ein gültiger Schlüssel aus einem anderen Workspace ist kein global gültiger Zugangsschlüssel.

Probiere Folgendes: Verwenden Sie einen Schlüssel aus dem Workspace mit dem vorgesehenen Profil oder richten Sie das Profil in dem Workspace ein, den Sie verwenden. Eine Änderung des Hostnamens in der Anfrage erstellt kein Profil.

Weitere Anfrage- und Task-Fehler finden Sie unter Fehler der CAPTCHA-API.