ProxyWing
浏览端点

ProxyWing 开发者 API

指纹

在数据中心和 ISP 代理上开启或关闭操作系统/浏览器 TCP 指纹（p0f），或切换配置文件。

GET /spoofing/profiles

列出指纹配置文件

返回可应用于数据中心或 ISP 订单的操作系统/浏览器 TCP-IP（p0f）指纹配置文件。更改订单的指纹时，请使用配置文件的 slug。

验证 · Bearer
请求 GET /spoofing/profiles
curl -X GET "https://api.proxywing.com/v1/spoofing/profiles" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
响应 200 · application/json
{
  "profiles": [
    {
      "slug": "windows-11-23h2-chrome",
      "label": "Windows 11 · Chrome",
      "tags": [
        "windows",
        "chrome"
      ]
    },
    {
      "slug": "android-14-chrome",
      "label": "Android 14 · Chrome",
      "tags": [
        "android",
        "chrome"
      ]
    }
  ]
}
GET /datacenter/orders/{ord_id}/spoofing

获取订单的指纹

返回当前应用于数据中心订单的操作系统指纹。status 为 enabled（正在伪装返回的 profile）、disabled（未伪装）、pending 或 failed。对于 ISP 订单，请使用 /isp/orders/{ord_id}/spoofing 下的相同路径。

验证 · Bearer

路径参数

  • ord_id string 必填

    订单 ID，可从 GET /datacenter/proxies 获取。

请求 GET /datacenter/orders/{ord_id}/spoofing
curl -X GET "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/spoofing" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
响应 200 · application/json
{
  "order_id": "ord_100001",
  "profile": "windows-11-23h2-chrome",
  "status": "enabled",
  "updated_at": "2026-07-03T10:50:03Z"
}
POST /datacenter/orders/{ord_id}/spoofing

设置订单的指纹

为数据中心订单设置操作系统/浏览器指纹：如果订单当前没有指纹，则启用伪装；如果已启用，则切换配置文件。执行 DELETE 后，可通过此方式重新开启伪装。ISP 订单也可通过 /isp/orders/{ord_id}/spoofing 使用。注意：新指纹仅适用于新连接——切换后请关闭现有的 keep-alive 连接池并开启新会话，并使应用层信号（User-Agent、客户端提示）与所选配置文件保持一致。配置文件未知时返回 400；仅当订单的伪装记录处于临时状态或检测到多主机漂移时才返回 409，此时请稍后重试。

验证 · Bearer

路径参数

  • ord_id string 必填

    要更改指纹的订单 ID。

请求体参数

  • profile string 必填

    从 GET /spoofing/profiles 获取的配置文件 slug。

请求 POST /datacenter/orders/{ord_id}/spoofing
curl -X POST "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/spoofing" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"profile":"android-14-chrome"}'
响应 200 · application/json
{
  "order_id": "ord_100001",
  "profile": "android-14-chrome",
  "status": "enabled",
  "updated_at": "2026-07-03T10:50:02Z"
}
DELETE /datacenter/orders/{ord_id}/spoofing

关闭订单的指纹

禁用数据中心订单的伪装——代理将恢复为其原生 TCP 指纹。ISP 订单也可通过 /isp/orders/{ord_id}/spoofing 使用。不影响计费且具备幂等性：禁用已处于禁用状态的订单会成功而不会报错，因此重试是安全的。撤销操作会进入队列，大约需要 60–90 秒才能在所有代理主机上生效，因此响应报告的是实时状态，而不是声称更改已经完成——请对同一路径轮询 GET，直到 status 显示为 disabled。

验证 · Bearer

路径参数

  • ord_id string 必填

    要关闭伪装的订单 ID。

请求 DELETE /datacenter/orders/{ord_id}/spoofing
curl -X DELETE "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/spoofing" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
响应 200 · application/json
{
  "order_id": "ord_100001",
  "profile": null,
  "status": "disabled",
  "updated_at": "2026-07-26T08:31:44Z"
}