使用 Gemlogin API 进行浏览器自动化的综合指南

Gemlogin API 是一个强大的应用程序编程接口 (API)，允许您完全通过源代码控制和集成 Gemlogin 的 Antidetect 浏览器平台。使用 Gemlogin API，可以通过 HTTP 端点即时创建、配置、启动、监控和关闭浏览器配置文件，无需 GUI 操作。这为您带来以下机会：

• 自动化：构建工作流程，并行运行多个配置文件。
• 灵活集成：连接到 CRM、ERP、Google Sheets 或任何第三方系统。
• 扩大规模：轻松管理具有不同指纹的数千个配置文件。

1. 身份验证和常规配置

对 Gemlogin API 的每个请求都需要一个身份验证标头：

httpCopy编辑授权：持有人
内容类型：application/json

• 持有者令牌：从 Gemlogin 仪表板页面获取。
• 暂停：默认60s，可根据应用需求自定义。
• 数据格式：请求和响应均为 JSON。

2. 主要终点

2.1. 浏览器版本

• 获取/api/browser_versions
  获取支持的浏览器版本列表（Chrome、Firefox……）。jsonCopyEdit[{“id”：“chrome_100”，“name”：“Chrome”，“version”：“100.0.4896.127”}，{“id”：“firefox_98”，“name”：“Firefox”，“version”：“98.0”} // … ]

2.2. 群组

• 获取/api/groups
  列表查询 团体 profile，方便对常用配置进行分类赋值。jsonCopyEdit[ { "id": "grp1", "name": "美国客户" }, { "id": "grp2", "name": "测试人员" } ]

2.3. 个人资料

1. 列表和详细信息
   • 获取 /api/profiles
     获取所有创建的配置文件。
   • 获取/api/profile/{id}
     通过以下方式获取个人资料详细信息 {ID}.
2. 创建和更新
   • POST /api/profiles/create
     使用有效载荷示例创建新的配置文件：jsonCopyEdit{ “名称”：“FB-Account-1”， “浏览器版本”：“chrome_100”， “代理”：{ “主机”：“1.2.3.4”， “端口”：8000， “用户名”：“”， “密码”：“” }，“指纹”：“默认”， “时区”：“美国/纽约” }
   • POST /api/profiles/update/{profile_id}
     更新现有的配置文件配置（代理、指纹、时区……）。
3. 删除和更改指纹
   • 获取 /api/profiles/delete/{id}
     根据 ID 删除个人资料。
   • 获取/api/profiles/changeFingerprint
     刷新一个或多个配置文件的指纹，有助于避免长期跟踪。
4. 启动并关闭浏览器实例
   • 获取 /api/profiles/start/{id}
     从配置文件中生成浏览器实例。
     • 回复：用于控制的 WebSocket URL（Puppeteer、Playwright……）。
   • 获取 /api/profiles/close/{id}
     关闭（终止）配置文件正在运行的浏览器实例。

3. 如何在实践中使用API

示例 1：创建并运行配置文件

bash复制编辑# 1. 创建新的配置文件 curl -X POST https://api.gemlogin.io/api/profiles/create \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name":"MyProfile01", "browserVersion":"chrome_100", "proxy":{"host":"proxy.my.com","port":3128}, "fingerprint":"random" }' # 2. 启动新创建的配置文件 curl -X GET https://api.gemlogin.io/api/profiles/start/{PROFILE_ID} \ -H "Authorization: Bearer $TOKEN"

示例 2：使用 Node.js 脚本批量运行

javascript复制编辑const axios = require('axios'); const API = 'https://api.gemlogin.io/api'; const token = process.env.GEMLOGIN_TOKEN; async function runProfile(profileId) { const { data } = await axios.get(`${API}/profiles/start/${profileId}`, { headers: { Authorization: `Bearer ${token}` } }); console.log('WebSocket URL:', data.wsUrl); // 继续通过 Puppeteer/Playwright 控制浏览器…… } (async () => { // 获取配置文件列表 const { data: profiles } = await axios.get(`${API}/profiles`, { headers: { Authorization: `Bearer ${token}` } }); for (let p of profiles) { await runProfile(p.id); } })();

4. 管理与监控

• 日志：使用相同的端点 获取 /api/logs/{run_id} （如果可用）或通过 SDK 获取调试详细信息。
• 资源状态：更新个人资料状态（“有效”、“无效”、“无效”）以与业务系统同步。

5. 技巧与最佳实践

1. 速率限制：默认~100 个请求/分钟，如果您需要更高的请求，请联系支持。
2. 重试逻辑：使用重试/退避机制处理 5xx 错误。
3. 指纹旋转： 结合 更改指纹 定期增加随机性。
4. 基于组的配置：按地区或用例创建多个组，以便于管理。

总结

和 Gemlogin API，你完全主动 一体化, 延长 和 优化 Antidetect 浏览器自动化工作流程。从配置文件操作、指纹管理，到启动和关闭浏览器实例，一切都可以通过命令行或代码完成。让我们开始吧！ Gemlogin API 今天就为您的项目提高性能、减少运营工作量并优化成本！

文档： https://manual-gemlogin-vn.gitbook.io/gemlogin/tai-lieu-api/api

网站： gemlogin.vn