solvethree in Postman testen

Von solvethree4 Min. Lesezeit

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. 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. 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. 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. 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.

Umgebungswerte für den manuellen Test
Umgebungswerte für den manuellen Test
VariableEinzutragender Wert
SOLVETHREE_API_KEYDer private API-Schlüssel Ihres Workspaces. Das Bearer-Token der Sammlung verweist auf diese Variable.
SITEDer Zielhostname, keine vollständige Seiten-URL.
ACTIONDie reCAPTCHA-Aktion, die von der Zielanfrage verwendet wird.
PROXYDie HTTP- oder HTTPS-Proxy-URL für diesen Test, bei Bedarf einschließlich Zugangsdaten.
REQUEST_IDEin neuer Wert für jeden neuen logischen Task: 1–64 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche.
TASK_IDAnfangs 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.

Postman · Anfrage-Body mit privaten Umgebungswerten
{
  "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.

Vorgehen für jeden Task-Status
Vorgehen für jeden Task-Status
StatusNächster Schritt
pending oder solvingDer Task ist noch nicht abgeschlossen. Warten Sie und senden Sie Retrieve task dann erneut mit derselben TASK_ID.
readyBeenden Sie die Abrufe. Der Task enthält eine nutzbare Lösung.
failedBeenden 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.

Führe deinen ersten Task aus.

Starte mit $5 Workspace-Guthaben.

Workspace erstellen
solvethree in Postman testen · solvethree