Postmanでsolvethreeをテストする

1. 1.

   ダウンロードしたJSONをインポートする

   Postmanで「インポート」を選択し、コレクションファイルを選びます。このファイルには、Bearer認証を継承し、変数プレースホルダーを使用する「タスクを作成」と「タスクを取得」が含まれています。

2. 2.

   サイトのプロファイルを確認する

   ワークスペースには、対象のホスト名に対応する有効なプロファイルが必要です。テスト前にコンソールで設定してください。ホスト名とアクションを送信しても、プロファイルは作成されません。サイトプロファイルの設定を参照してください。

3. 3.

   非公開の環境値を設定する

   このテスト用の環境を作成して選択してください。プロキシの認証情報も含め、以下の値は非公開で設定してください。シークレットをコレクションに直接記載したり、シークレットが入力された状態でエクスポートしたりしないでください。

4. 4.

   Bearer認証を設定する

   コレクションレベルで「Bearerトークン」を選択し、ワークスペースのAPIキーを格納した非公開の環境変数を参照してください。両方のリクエストは、認証を継承する設定のままにします。APIは、Authorization: Bearerに続けてそのキーを指定する形式を受け付けます。

「タスクを作成」を開きます。このリクエストは、選択した環境の値を設定した生のJSON本文を使い、https://api.solvethree.com/v1/tasks にPOSTを送信します。

{
  "site": "{{SITE}}",
  "action": "{{ACTION}}",
  "proxy": "{{PROXY}}",
  "requestId": "{{REQUEST_ID}}"
}

このリクエストはデフォルトでreCAPTCHA Enterprise v3を使用します。type フィールドや url フィールドは追加しないでください。単一の proxy を指定するため、proxyCandidates も追加しないでください。この2つのフィールドは、どちらか一方だけが必要です。

送信前に REQUEST_ID を設定し、「送信」を1回クリックしてください。まずHTTPレスポンスを確認します。成功以外の場合は、本文を成功したタスクのレスポンスとして扱わず、リクエストのエラーを確認してください。無効な入力はそのまま繰り返し送信せず、修正してください。

作成レスポンスが成功した場合は、返された id を非公開の環境値 TASK_ID にコピーしてください。進捗を確認するために「タスクを作成」を再度クリックしないでください。

「タスクを取得」を開き、TASK_ID に返されたタスクIDが設定されていることを確認します。このリクエストは同じAPIのGET /v1/tasks/:idを使用します。手動で送信し、HTTPレスポンスを確認してから、タスクの status を確認してください。

HTTP 200または201だけでは、ソリューションの準備完了を意味しません。準備完了を示すのは status: ready だけです。この手動テストではタスクの作成と取得を確認しますが、対象のウェブサイトが結果を受け入れるかどうかは確認しません。

続けてreCAPTCHAトークンを本来の対象に送信する場合は、返された userAgent と secChUa のブラウザー識別情報、および成功したプロキシを使用してください。IPを切り替えたり、無関係なブラウザー識別情報を混在させたりしないでください。準備が完了したトークンでも、対象に拒否される場合があります。

接続がタイムアウトしても、作成が失敗したとは限りません。タスクIDがある場合は、そのタスクを取得してください。IDを受け取っていない場合は、同じ REQUEST_ID と変更していないタスク入力で「タスクを作成」を再送信してください。これにより、論理的に別のタスクを作成するのではなく、既存のタスクを復旧できます。

レスポンスが失われたという理由だけで、新しい REQUEST_ID を生成しないでください。同じIDを異なるタスク入力で再利用すると競合します。意図的に新しいタスクを開始する場合に、新しいIDを使用してください。