初めに
CapSolverのサービスの使用方法を学ぶために、以下のステップに従ってください。
ステップ 1: アカウントを作成
CapSolverのサービスを使用する準備ができる前に、ユーザーパネルにアクセスし、アカウントを登録する必要があります。 登録するための多くの方法があります。希望の登録方法が表示されない場合は、お問い合わせください。
ステップ 2: APIキーを取得
登録が完了したら、ホームページパネルからAPIキーを取得できます。
ステップ 3: タスクを作成
キーが用意できたら、APIメソッドcreateTaskを使用してタスクを作成できます。以下は、httpリクエストのパラメータの例です。
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
"cookies": "cookiename=1;cookiename=2;cookieName=3"
}
}
アカウントが十分な残高と正しいパラメータでリクエストを送信すると、次のAPIレスポンスが返されます。
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
// このIDを控えて、後続のクエリ結果で使用します
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
現在、さまざまなタイプのタスクをサポートしています。タスクの種類を区別するためにパラメーター task > type
を使用できます。
- 画像認識/音声認識
- キャプチャ(トークン)
ステップ 4: タスク結果を取得
通常、識別タスクはcreateTaskを介して直接結果を返します。しかし、タスクトークンは時間がかかるため、getTaskResultを別途経由してタスクの結果を取得する必要があります。
ヘッダー
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
// 最初のステップcreateTaskによって返された結果
"taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4"
}
一般的には ‘1-10秒’ 待つだけで、getTaskResultを介してタスクの実行結果を取得できます。以下は成功したレスポンスです。アカウント内で十分な残高と正しいパラメータでリクエストを送信した場合、次のAPIレスポンスが返されます。
{
"errorId": 0,
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}