APIDolphin {anty} API 创建配置文件模板

Dolphin {anty} API 创建配置文件模板

下面是通过 API 创建配置文件的几个要点,以及创建配置文件的请求示例 ⬇️

User-Agent 🌐

向以下地址发送 GET 请求,可以获取所需配置文件平台(操作系统)的 user agent:

在 URL 末尾的 &platform= 后面,可以指定需要的平台:MacOS、Windows、Linux。只有在请求中带上值为 Bearer API_TOKEN 的 Authorization 请求头,才会返回 user agent。

WEBGLinfo 👾

向以下地址发送 GET 请求,可以获取所需配置文件平台(操作系统)的 WebGL 值:

在 URL 末尾的 &platform= 后面,可以指定需要的平台:MacOS、Windows、Linux。只有在请求中带上值为 Bearer API_TOKEN 的 Authorization 请求头,才会返回 WebGL 配置。

硬件兼容性 🧩

platform(操作系统)、webglInfo(显卡)、cpu(核心数)和 memory 参数会对照真实设备配置表检查兼容性。例如,搭配 NVIDIA 显卡的 macOS,或 2 核配 64 GB 内存,都会被视为不正确的组合。

如果请求中包含不兼容的组合,配置文件不会被创建:API 会返回错误,并指出具体哪个组合不正确。

💡 为避免出错,请用上一节的请求,获取与配置文件相同平台的 WebGL info。如果之前一切正常、现在配置文件却创建不了,请查看 API 的响应:很可能是硬件不兼容。

已经创建的配置文件会照常使用。

创建配置文件的示例代码 🛠️

ℹ️ 这个示例用 Python 编写。它向 API 发送 POST 请求,按指定设置创建浏览器配置文件(这里是一个 Windows 配置文件,user agent 基于 Chrome 140 内核)。

import requests

url = "https://dolphin-anty-api.com/browser_profiles"
headers = {"Content-Type": "application/json", "Authorization": "Bearer API_TOKEN"}

payload = {
    "name": "Profile",
    "platform": "windows",
    "browserType": "anty",
    "mainWebsite": "",
    "useragent": {
        "mode": "manual",
        "value": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36"
    },
    "webrtc": {"mode": "altered", "ipAddress": None},
    "canvas": {"mode": "real"},
    "webgl": {"mode": "real"},
    "webglInfo": {
        "mode": "manual",
        "vendor": "Google Inc. (Intel)",
        "renderer": "ANGLE (Intel, Intel(R) Iris(R) Xe Graphics Direct3D11 vs_5_0 ps_5_0, D3D11)",
        "webgl2Maximum": "{"UNIFORM_BUFFER_OFFSET_ALIGNMENT":256,"MAX_TEXTURE_SIZE":16384}"
    },
    "timezone": {"mode": "auto", "value": None},
    "locale": {"mode": "auto", "value": None},
    "cpu": {"mode": "manual", "value": 4},
    "memory": {"mode": "manual", "value": 8},
    "screen": {"mode": None, "resolution": None},
    "doNotTrack": False,
    "osVersion": "10"
}

resp = requests.post(url, headers=headers, json=payload)
print(resp.status_code, "
", resp.text)

ℹ️ 大部分请求及其参数在我们的完整文档中都有详细说明,地址在这里 🧑‍💻

ℹ️ User-agent 参数只能在 manual 模式下使用。WebGL info 和 User-agent 都需要提前请求获取,我们建议使用 Dolphin{anty} 提供的值。