Akamai Bot Manager 解決 API：_abck などのセッション Cookie を取得

SolveHub API で Akamai Bot Manager のブラウザーセッション Cookie（_abck、bm_sz）を取得。フィールド、プロキシ要件、cURL 例、結果形式、エラーコード。

許可された QA 自動化とブラウザー連携向けです。テスト権限のあるサイトと業務フローでのみ使用してください。

Akamai で保護されたページの websiteURL と HTTP プロキシは必須です。任意の ApiURL（大文字・小文字に注意）は解決セッション内の POST 先として使用され、完全な HTTP(S) URL である必要があります。このタイプではカスタムの useragent フィールドは受け付けません。

ブラウザーの選択

任意の useragent で Chrome/Chromium または Firefox のファミリー、プラットフォーム、メジャーバージョンを選択できます。ノードにないバージョンを指定すると失敗します。省略時は既定のブラウザーを使用します。Cookie を再利用するときは、同じプロキシと実際に返却された solution.useragent を使用してください。

リクエストフィールド

外側の type と task は必須です。以下の task.* パスはすべて task オブジェクト内にあります。フィールド名は大文字と小文字を区別します。長さの制限は UTF-8 のバイト数で計算されます。

フィールド	型	必須	制限	説明
`type`	文字列	はい	`akamai` 固定	プラットフォームのタスクタイプ。
`task`	JSON オブジェクト	はい	≤ 7 MiB	このタイプのタスクパラメータ。
`task.type`	文字列	いいえ	指定する場合は `akamai` であること	旧リクエスト形式との互換用です。新規の連携では省略できます。
`task.websiteURL`	HTTP(S) URL	はい	≤ 2048 バイト	解決対象ページの完全な URL です。アカウント名やパスワードは含めないでください。
`task.ApiURL`	HTTP(S) URL	いいえ	≤ 2048 バイト	ブラウザセッション内でリクエストする POST 先です。フィールド名は大文字と小文字を区別します。レスポンス本文は解決結果として返されません。
`task.useragent`	文字列	いいえ	≤ 512 バイト	ブラウザーの選択。Cookie は返却された `solution.useragent` と共に再利用してください。
`task.proxyType`	文字列	はい	`http` のみ	プロキシのプロトコルです。指定する場合は `http` である必要があります。
`task.proxyAddress`	文字列	はい	≤ 256 バイト	プロキシの IP アドレスまたはホスト名です。`proxyPort` と併せて指定する必要があります。
`task.proxyPort`	文字列	はい	1–5 バイト、値は 1–65535	プロキシのポートです。引用符で囲んだ数字の文字列で指定する必要があります。
`task.proxyLogin`	文字列	いいえ	≤ 256 バイト	プロキシに認証が必要な場合のユーザー名です。アドレスとポートを指定せずに単独で指定することはできません。
`task.proxyPassword`	文字列	いいえ	≤ 256 バイト	プロキシに認証が必要な場合のパスワードです。アドレスとポートを指定せずに単独で指定することはできません。

作成リクエストの例

{
  "type": "akamai",
  "task": {
    "websiteURL": "https://example.com/protected",
    "proxyType": "http",
    "proxyAddress": "203.0.113.10",
    "proxyPort": "8080"
  }
}

cURL での呼び出し

例の API キー、サイト情報、プロキシを実際の値に置き換えてください。Idempotency-Key は同一の業務リクエストに対して同じ値を維持してください。

curl -sS -X POST 'https://www.tiam.codes/v1/tasks' \
  -H 'Authorization: Bearer sh_REPLACE_ME' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-akamai-0001' \
  --data-binary @- <<'JSON'
{
  "type": "akamai",
  "task": {
    "websiteURL": "https://example.com/protected",
    "proxyType": "http",
    "proxyAddress": "203.0.113.10",
    "proxyPort": "8080"
  }
}
JSON

作成レスポンスと照会

作成に成功すると HTTP 202 が返され、status の初期値は通常 queued です。taskId を保存し、約 2–3 秒ごとに GET /v1/tasks/{taskId} を呼び出して照会してください。このタイプの処理のソフトタイムリミットは 180 秒 です。ソフトタイムリミットを超えると uncertain になる場合があります。受理済みのタスクの結果は引き続き確認できるため、クライアントは新しい冪等キー（Idempotency-Key）で安易に再作成しないでください。

結果フィールド

solution は status=completed の場合にのみ読み取ってください。下表は主なフィールドの一覧です。実際のフィールドは当該タスクのレスポンスに従ってください。

フィールド	型	読み取り方法
`solution.cookies`	オブジェクト	対象サイトのセッション Cookie（`_abck`、`ak_bmsc`、`bm_sz` など）。
`solution.headers`	オブジェクトまたは null、任意	後続のリクエストで再利用するブラウザヘッダーです。null の場合があります。
`solution.useragent`	文字列	後続のリクエストで使用する User-Agent。

結果には通常 solution.cookies と solution.useragent が含まれ、solution.headers が含まれる場合もあります（null の場合もあります）。Cookie には _abck、ak_bmsc、bm_sz などが含まれることがありますが、実際の内容は結果に従ってください。結果の例：{"cookies":{"_abck":"EXAMPLE_COOKIE"},"headers":null,"useragent":"Mozilla/5.0 ..."}。利用時は同じプロキシと、返された User-Agent を維持してください。

失敗とトラブルシューティング

ApiURL と websiteURL は役割が異なり、フィールド名は大文字と小文字を区別します。結果の headers は null の場合があるため、コード側で先に型を確認してください。

作成リクエストでよく発生するエラーは 400 INVALID_TASK、402 INSUFFICIENT_BALANCE、429 TASK_LIMIT_EXCEEDED、503 TYPE_UNAVAILABLE です。作成済みのタスクが失敗した場合の公開エラーコードは TASK_FAILED または TASK_TIMEOUT で、uncertain は TASK_UNCERTAIN に対応します。詳しくはプラットフォーム API リファレンスを参照してください。

処理時間はタスク作成の受理確認後に起算し、待ち行列の時間は差し引きません。ノードの現在のタイムアウトは約75秒、プラットフォームのソフト期限は通信と結果確認を含め180秒です。

対応 User-Agent