SDKとMCPOpenAPIMarkdownリファレンス対応製品

初めての解決

1回のリクエストでトークン、ヘッダーセット、またはCookieを生成し、発行対象の識別情報とともに送信します。

REST · v1

クイックスタート

  1. 01トークンを生成
  2. 02Kasadaを生成
  3. 03TMPTを生成
  4. 04非同期フォールバック
  5. 05失敗への対処

ベースURL

https://api.solvethree.com/v1

認証

Authorization: Bearer <key>

Markdown形式の完全な連携リファレンス。

トークンを生成

POST /v1/tasks · 201

curl https://api.solvethree.com/v1/tasks \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://user:[email protected]:8080",
    "requestId": "login_20260910_0001"
  }'
{
  "id": "login_20260910_0001",
  "status": "ready",
  "solution": {
    "token": "03AFcWeA5…kQ2b",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
  },
  "durationMs": 1742
}

作成リクエストは最大15秒待機し、通常は生成済みのトークンを返します。サイトには、このワークスペース内で有効なプロファイルが必要です。無制限プランに割り当てられたサイトはプランに含まれ、それ以外のサイトでは従量課金クレジットが1件分確保されます。

任意フィールド（proxyまたはproxyCandidatesは必須）

recaptchaType
通常のv3には"v3"を使用してください。省略すると、後方互換性のある既定値"enterprise-v3"が使用されます。
requestId
独自の冪等性キー。1–64文字。同じキーを再送すると、同じタスクが返されます。
proxyCandidates
異なるHTTP(S)プロキシを最大6つ指定できます。solution.egressAttemptsは、成功した候補の1始まりのインデックスです。セッションには単一のプロキシが必要です。
userAgent, secChUa
トークンとともに使用するブラウザー識別情報を固定します。
timezoneOffsetMinutes
トークンを送信するクライアントのタイムゾーンに合わせてください。
session
複数のステップからなるフローで、タスク間のセッションを維持します。

Kasadaヘッダーを生成

1,000件あたり$1.25 · 失敗したジョブは返金

curl https://api.solvethree.com/v1/tasks \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "KasadaTask",
    "url": "https://www.ticketmaster.com/discovery/v2/events",
    "proxy": "http://user:[email protected]:8080"
  }'
{
  "id": "req_92ad…",
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
    "headers": {
      "x-kpsdk-ct": "…",
      "x-kpsdk-cd": "…",
      "x-kpsdk-h": "…",
      "x-kpsdk-v": "…"
    },
    "egressAttempts": 1
  }
}

スタンドアロンのKasadaは現在、www.ticketmaster.comのHTTPSターゲットに対応しています。返されたすべてのヘッダーを、返されたブラウザー識別情報と成功したプロキシとともに直ちに適用してください。ヘッダーセットは、ターゲット、識別情報、送信元に紐づいています。これらのタスクをプランに含めるには、Kasadaを無制限プランの枠に割り当ててください。

Ticketmaster TMPTを生成

1,000件あたり$0.99 · 失敗したジョブは返金

curl 'https://api.solvethree.com/v1/tasks?waitMs=75000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "TicketmasterTmptTask",
    "url": "https://www.ticketmaster.com/example/event/1A2B3C4D5E6F7A8B",
    "action": "Event",
    "proxy": "http://user:[email protected]:8080"
  }'
{
  "id": "req_7f4c…",
  "status": "ready",
  "solution": {
    "token": "tmpt-cookie-value…",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
    "egressAttempts": 1
  },
  "durationMs": 2310
}

TicketmasterのURLは必須ですが、リクエストIDは必須ではありません。actionには、正確なイベントURLとともにEventを、サインイン開始URLとともにLoginを使用してください。TMPTの作成は既定で最大1.5秒待機するため、準備済みの解決結果を直接返せます。新規処理は保留中のタスクにフォールバックします。完全に非同期で作成するにはURLクエリパラメーターをwaitMs=0に設定し、上限付きの待機時間を延長するには最大waitMs=75000に設定してください。その後、タスクのステータスを確認し、終了状態でなければポーリングしてください。トークンはtmpt Cookieの生の値です。これらのタスクをプランに含めるには、Ticketmaster TMPTを無制限プランの枠に割り当ててください。

非同期フォールバック

GET /v1/tasks/:id · 200

curl https://api.solvethree.com/v1/tasks/login_20260910_0001 \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY"
pendingタスクは受け付けられましたが、まだ取得されていません。
solvingワーカーがトークンを生成しています。
readysolutionでトークンを取得できます。課金済みです。
failederrorCodeを確認してください。クレジットは返金されます。
{
  "id": "login_20260910_0001",
  "status": "ready",
  "solution": {
    "token": "03AFcWeA5…kQ2b",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
    "secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
  },
  "durationMs": 1742
}

ほとんどの連携では、このリクエストは必要ありません。作成レスポンスが同期処理の待機時間を過ぎてもpendingまたはsolvingのままの場合、または接続中断後に冪等なタスクを復元する場合にのみ使用してください。Kasadaは最大75秒、reCAPTCHAは15秒待機します。TMPTは既定で最大1.5秒待機します。完全に非同期で作成するにはwaitMs=0を使用し、待機時間を指定するにはTMPTのwaitMsを最大75秒に設定してください。

失敗への対処

status · failed

{
  "id": "login_20260910_0001",
  "status": "failed",
  "errorCode": "site-unreachable",
  "error": "target page did not respond",
  "durationMs": 9210
}
401無効なAPIキー
402クレジット不足
403サイトプロファイルが有効ではありません
409リクエストIDの競合
429レート制限を超過 · retry-after: 60
502生成サービスを利用できません · 返金済み
503生成サービスが処理上限に達しています · 返金済み · retry-after: 1

識別情報を同梱

トークンには、発行対象のuserAgentとsecChUaが付属します。これらを一緒に送信してください。

解決失敗時は無料

failedで終了したタスクの料金は、自動的に残高に返金されます。

シークレットを保護

トークン、Cookie、プロキシ、フィンガープリントは、タスク一覧やログに含まれません。

APIドキュメント · solvethree