Die CAPTCHA-API in Insomnia testen

Sie benötigen einen Workspace-API-Schlüssel, ein aktives Profil für die Zielwebsite und einen Proxy. Richten Sie das Websiteprofil ein, bevor Sie die Aufgabe senden: Die Angabe eines Hostnamens und einer Aktion erstellt kein Profil.

Verwenden Sie eine private lokale Umgebung namens solvethree-local mit den folgenden Variablen. Diese Namen wurden für diese Anleitung gewählt und sind keine zusätzlichen API-Felder. Halten Sie den API-Schlüssel und die Proxy-Zugangsdaten aus gemeinsam genutzten Konfigurationen heraus.

1. 1.

   Erstellungsanfrage konfigurieren

   Erstellen Sie eine POST-Anfrage mit api_base, gefolgt von /tasks. Fügen Sie den Abfrageparameter waitMs mit dem Wert 0 hinzu. Wählen Sie die Bearer-Authentifizierung und geben Sie api_key als Token an; die Anfrage muss einen Authorization-Header mit dem Bearer-Schema senden.

2. 2.

   JSON-Body erstellen

   Wählen Sie einen JSON-Body mit site, action, proxy und requestId. Befüllen Sie die ersten drei aus den entsprechenden lokalen Variablen und requestId aus request_id. Senden Sie genau eines der Felder proxy oder proxyCandidates; diese Anleitung verwendet proxy. Fügen Sie weder type noch url hinzu. Wenn Sie recaptchaType weglassen, wird der Standardwert enterprise-v3 verwendet.

3. 3.

   Senden und Antwort prüfen

   Prüfen Sie die HTTP-Antwort, bevor Sie sie als erfolgreiche Aufgabenantwort auslesen. Wenn die Erstellung erfolgreich ist, kopieren Sie die zurückgegebene Aufgaben-ID nach task_id. Bewahren Sie den Aufgaben-Body und request_id auf, falls Sie die Anfrage wiederherstellen müssen.

4. 4.

   Diese Aufgabe abrufen

   Erstellen Sie eine GET-Anfrage mit api_base, gefolgt von /tasks/ und der kopierten Aufgaben-ID. Setzen Sie waitMs auf 15000, verwenden Sie denselben Bearer-Schlüssel und lassen Sie den Body leer. Kopieren Sie die ID manuell; diese Anleitung setzt keinen Ausdruck zur Verkettung von Antworten voraus.

Create task
  Method: POST
  URL: https://api.solvethree.com/v1/tasks?waitMs=0
  Auth: Bearer Token — your private workspace key
  Body: JSON — site, action, proxy and a stable requestId

Retrieve task
  Method: GET
  URL: https://api.solvethree.com/v1/tasks/PASTE_RETURNED_ID?waitMs=15000
  Auth: Bearer Token — the same workspace key
  Body: none

Keep the task's proxy in the JSON body. Insomnia's own network proxy setting
controls its API connection, not the proxy used to generate/submit the solution.

Die HTTP-Anfrage liefert eine nicht erfolgreiche Antwort.

Prüfen Sie den HTTP-Fehler, bevor Sie versuchen, eine erfolgreiche Aufgabenantwort auszulesen.

Probiere Folgendes: Beheben Sie das gemeldete Anfrage- oder Authentifizierungsproblem. Senden Sie unveränderte ungültige Eingaben nicht wiederholt und gehen Sie nicht davon aus, dass jeder Fehler auf unzureichendes Guthaben hinweist.

Die Aufgabe hat den Status pending oder solving.

Keiner der beiden Status enthält eine nutzbare Lösung.

Probiere Folgendes: Senden Sie die GET-Anfrage für dieselbe Aufgaben-ID erneut. Erstellen Sie keine weitere Aufgabe, nur weil diese noch nicht abgeschlossen ist.

Die Aufgabe hat den Status failed.

Lesen Sie errorCode und error; site-unreachable ist ein möglicher Aufgabenfehler.

Probiere Folgendes: Rufen Sie diese Aufgabe nicht weiter ab und beheben Sie die gemeldete Ursache, bevor Sie eine weitere starten. Fehlgeschlagene Lösungsversuche werden erstattet.

Die Erstellungsanfrage überschreitet das Zeitlimit, ohne eine ID zurückzugeben.

Eine Verbindungszeitüberschreitung beweist nicht, dass die Erstellung fehlgeschlagen ist.

Probiere Folgendes: Senden Sie denselben Aufgaben-Body mit derselben requestId erneut, um die vorhandene Aufgabe wiederherzustellen. Wenn Sie die Eingaben ändern und diese ID erneut verwenden, entsteht ein Konflikt.

Eine reCAPTCHA-Aufgabe mit dem Status ready liefert ein Token. Wenn Sie es an das Ziel übermitteln, verwenden Sie die zurückgegebenen Werte userAgent und secChUa mit demselben Proxy, der beim Lösen verwendet wurde. Eine Antwort mit dem Status ready bestätigt, dass eine Lösung generiert wurde – nicht, dass Ihre Anwendungsanfrage erfolgreich war.