Imperva Incapsula 解決 API：reese84 と utmvc Cookie

対象のチャレンジに応じてモードを選択してください。スクリプトのアドレスを混同しないでください。Reese84 では websiteURL,reeseScriptUrl が必要です。UT.mvc では websiteURL,isUtmvc:true,scriptURL が必要で、scriptURL は /_Incapsula_Resource?SWJIYLWA=... の完全なアドレスです。どちらのモードでも HTTP プロキシ、useragent、language は任意です。cookies はブラウザ Cookie の事前設定に使用でき、各項目には name,value のみを含めることができます。

ブラウザーの選択

useragent を指定する場合はデスクトップ Chrome/Chromium または Android Chrome を使用してください。Firefox、Edge、Opera、iOS は非対応です。Android の対応可否は互換性のあるデバイス指紋を生成できるかに依存します。

リクエストフィールド

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

Reese84 リクエスト：

作成リクエストの例

{
  "type": "imperva",
  "task": {
    "websiteURL": "https://example.com/protected",
    "reeseScriptUrl": "https://example.com/challenge/reese.js"
  }
}

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-imperva-0001' \
  --data-binary @- <<'JSON'
{
  "type": "imperva",
  "task": {
    "websiteURL": "https://example.com/protected",
    "reeseScriptUrl": "https://example.com/challenge/reese.js"
  }
}
JSON

UT.mvc リクエスト：

{
  "type": "imperva",
  "task": {
    "websiteURL": "https://example.com/protected",
    "isUtmvc": true,
    "scriptURL": "https://example.com/_Incapsula_Resource?SWJIYLWA=example"
  }
}

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-imperva-0001' \
  --data-binary @- <<'JSON'
{
  "type": "imperva",
  "task": {
    "websiteURL": "https://example.com/protected",
    "isUtmvc": true,
    "scriptURL": "https://example.com/_Incapsula_Resource?SWJIYLWA=example"
  }
}
JSON

作成レスポンスと照会

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

結果フィールド

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

結果には solution.cookies と solution.useragent が含まれます。Reese84 では通常 reese84、UT.mvc では通常 ___utmvc が含まれ、そのほかのセッション Cookie が付随する場合もあります。結果の例：{"cookies":{"reese84":"EXAMPLE_COOKIE"},"useragent":"Mozilla/5.0 ..."}。後続のリクエストでは、完全な Cookie セット、返された User-Agent、および解決時のプロキシの送信元 IP を再利用してください。

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

Reese84 と UT.mvc のスクリプトフィールドを混在させることはできません。cookies を送信する場合、各項目には name,value だけを過不足なく含める必要があります。プロキシのアドレスとポートは併せて指定してください。

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

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

対応 User-Agent