指紋認証を更新

API リファレンス

指紋認証を更新

Request

ブラウザープロファイルの指紋を再生成します。

前提条件：envId または uniqueId でプロファイルを指定します。暗号化されたプロファイルは拒否されます。起動中のプロファイルもブロックされませんが、新しい指紋は次回起動時から適用されます。
副作用：新しい指紋を生成し、ホスト名と MAC アドレスをランダム化し、ブラウザーカーネルを再マッチングします。リクエストで明示した値は生成値より優先されます。
完了シグナル：同期的です。
リトライ：自動リトライは絶対に行わないでください。 呼び出しごとに異なるランダムな指紋が生成されるため、タイムアウト後に無条件でリトライするとプロファイルが 2 度変更されます。まず /env/detail で比較してください。

文書化されたビジネスエラー: 19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193。各コードの意味は Error Codes を参照してください。どの操作でも共通コードが返る場合があります。

Bodyapplication/jsonrequired

envIdstringrequired

プロファイルID（環境ID）。envIdまたはuniqueIdのいずれか一方のみを指定してください。

uniqueIdstring

プロファイルシリアル番号（固有ID）。envIdまたはuniqueIdのいずれか一方のみを指定してください。

uaVersioninteger

ターゲットとなるユーザーエージェントのバージョン（例：Chrome 129）。

省略した場合、プロファイルに登録されている現在のユーザーエージェントのバージョンが使用されます。

Example:129

browserTypeIdinteger

ブラウザの種類。1＝Chrome、2＝Firefox。

Enum:12

operatorSystemIdinteger

オペレーティングシステムの種類。1 = Windows、2 = macOS、3 = Android、4 = iOS。

Enum:1234

advancedSettingobject(AdvancedSetting)

高度なブラウザフィンガープリントと動作設定。

curl -i -X POST \
  http://127.0.0.1:40000/api/env/fingerprint/refresh \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1869988538611834880",
    "uniqueId": "",
    "uaVersion": 129,
    "browserTypeId": 1,
    "operatorSystemId": 2,
    "advancedSetting": {}
  }'

Responses

成功。この操作の data は常に null です。結果は code で示されます。

Headers

any

Bodyapplication/json

codeinteger

msgstring or null

datanull

requestIdstring

Response

{
  "code": 0,
  "msg": null,
  "data": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}