solvethree in Postman testen
Importieren Sie die Postman-Sammlung ohne Zugangsdaten, konfigurieren Sie private Umgebungswerte und senden Sie Create task einmal. Prüfen Sie anschließend mit Retrieve task denselben Task, bis er abgeschlossen ist. Die Sammlung enthält keine automatischen Tests oder Skripte, die zusätzliche Tasks senden.
Auf dieser Seite
Sammlung importieren und konfigurieren
- 1.
Heruntergeladene JSON-Datei importieren
Wählen Sie in Postman Import und dann die Sammlungsdatei aus. Sie enthält Create task und Retrieve task mit geerbter Bearer-Autorisierung und Variablenplatzhaltern.
- 2.
Website-Profil prüfen
Ihr Workspace benötigt ein aktives Profil für den Zielhostnamen. Konfigurieren Sie es vor dem Test in der Konsole; das Senden eines Hostnamens und einer Aktion erstellt kein Profil. Siehe Website-Profil einrichten.
- 3.
Private Umgebungswerte konfigurieren
Erstellen und wählen Sie eine Umgebung für diesen Test aus. Tragen Sie die folgenden Werte privat ein, einschließlich etwaiger Proxy-Zugangsdaten. Hinterlegen Sie Geheimnisse nicht direkt in der Sammlung und exportieren Sie keine eingetragenen Geheimnisse.
- 4.
Bearer-Autorisierung konfigurieren
Wählen Sie auf Sammlungsebene Bearer Token aus und verweisen Sie auf eine private Umgebungsvariable, die den API-Schlüssel Ihres Workspaces enthält. Lassen Sie beide Anfragen die Autorisierung erben. Die API erwartet Authorization: Bearer, gefolgt von diesem Schlüssel.
| Variable | Einzutragender Wert |
|---|---|
| SOLVETHREE_API_KEY | Der private API-Schlüssel Ihres Workspaces. Das Bearer-Token der Sammlung verweist auf diese Variable. |
| SITE | Der Zielhostname, keine vollständige Seiten-URL. |
| ACTION | Die reCAPTCHA-Aktion, die von der Zielanfrage verwendet wird. |
| PROXY | Die HTTP- oder HTTPS-Proxy-URL für diesen Test, bei Bedarf einschließlich Zugangsdaten. |
| REQUEST_ID | Ein neuer Wert für jeden neuen logischen Task: 1–64 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche. |
| TASK_ID | Anfangs leer lassen. Kopieren Sie nach der Erstellung die zurückgegebene id hierher. |
Create task einmal senden
Öffnen Sie Create task. Die Anfrage sendet POST an https://api.solvethree.com/v1/tasks mit einem rohen JSON-Body, der aus Ihrer ausgewählten Umgebung befüllt wird.
{
"site": "{{SITE}}",
"action": "{{ACTION}}",
"proxy": "{{PROXY}}",
"requestId": "{{REQUEST_ID}}"
}Diese Anfrage verwendet standardmäßig reCAPTCHA Enterprise v3. Fügen Sie kein type- oder url-Feld hinzu. Sie übergibt einen einzelnen proxy; fügen Sie daher nicht zusätzlich proxyCandidates hinzu: Genau eines dieser Felder ist erforderlich.
Setzen Sie vor dem Senden REQUEST_ID und klicken Sie dann einmal auf Send. Prüfen Sie zuerst die HTTP-Antwort. Falls sie nicht erfolgreich ist, untersuchen Sie den Anfragefehler, statt den Body als erfolgreiche Task-Antwort zu behandeln. Korrigieren Sie ungültige Eingaben, statt sie wiederholt unverändert zu senden.
Kopieren Sie bei einer erfolgreichen Erstellungsantwort die zurückgegebene id in Ihren privaten Umgebungswert TASK_ID. Klicken Sie nicht erneut auf Create task, nur um den Fortschritt zu prüfen.
Die bestehende Aufgabe abrufen
Öffnen Sie Retrieve task und prüfen Sie, ob TASK_ID die zurückgegebene Task-ID enthält. Diese Anfrage verwendet GET /v1/tasks/:id auf derselben API. Senden Sie sie manuell, prüfen Sie die HTTP-Antwort und anschließend den status des Tasks.
| Status | Nächster Schritt |
|---|---|
| pending oder solving | Der Task ist noch nicht abgeschlossen. Warten Sie und senden Sie Retrieve task dann erneut mit derselben TASK_ID. |
| ready | Beenden Sie die Abrufe. Der Task enthält eine nutzbare Lösung. |
| failed | Beenden Sie die Abrufe. Prüfen Sie errorCode und error, um zu entscheiden, was geändert werden muss. Fehlgeschlagene Lösungsversuche werden erstattet. |
HTTP 200 oder 201 allein bedeutet nicht, dass eine Lösung bereitsteht; das zeigt nur status: ready an. Dieser manuelle Test prüft die Task-Erstellung und den Abruf, nicht, ob die Zielwebsite das Ergebnis akzeptiert.
Wenn Sie anschließend das reCAPTCHA-Token an das vorgesehene Ziel übermitteln, verwenden Sie die zurückgegebene Browseridentität aus userAgent und secChUa sowie den erfolgreichen Proxy. Wechseln Sie weder die IP-Adresse noch zu einer anderen Browseridentität. Ein fertiges Token kann vom Ziel weiterhin abgelehnt werden.
Wenn Create task das Zeitlimit überschreitet
Eine Verbindungszeitüberschreitung beweist nicht, dass die Erstellung fehlgeschlagen ist. Wenn Sie die Task-ID haben, rufen Sie den Task ab. Falls Sie die ID nie erhalten haben, senden Sie Create task mit derselben REQUEST_ID und unveränderten Task-Eingaben erneut. Dadurch wird der vorhandene Task wiederhergestellt, statt ein weiterer logischer Task erstellt.
Generieren Sie keine neue REQUEST_ID, nur weil die Antwort verloren gegangen ist. Die Wiederverwendung einer ID mit anderen Task-Eingaben verursacht einen Konflikt; verwenden Sie eine neue ID, wenn Sie bewusst einen neuen Task starten.
Quellen und API-Referenz
Führe deinen ersten Task aus.
Starte mit $5 Workspace-Guthaben.