比特指纹浏览器Local API是什么？

Local API支持哪些核心操作？

浏览器窗口的创建与管理

• 支持创建和配置浏览器窗口：通过/browser/update接口创建带有独立指纹配置的浏览器窗口，可传入操作系统、分辨率、时区、语言、Canvas、WebGL等全部指纹参数，并配置代理IP。创建成功后返回窗口ID，作为后续所有操作的唯一标识。
• 支持打开和关闭浏览器窗口：通过/browser/open接口启动已创建的浏览器窗口，启动成功后返回该窗口的调试地址（DevTools URL），供Selenium/Playwright等自动化框架连接使用。通过/browser/close接口可关闭指定窗口。
• 支持删除浏览器窗口：通过/browser/delete接口删除不再需要的窗口环境，释放系统资源。删除操作不可恢复，执行前需确认窗口数据已备份或不再需要。

指纹参数与代理的动态配置

• 支持动态修改指纹参数：通过Local API可在窗口运行过程中修改指纹参数，包括切换操作系统类型、调整屏幕分辨率、修改时区和语言、更改Canvas噪音值等。修改后需重新打开窗口才能生效。
• 支持代理配置的灵活管理：通过API可动态为窗口绑定或更换代理IP，支持HTTP、HTTPS、SOCKS5等多种协议。更换代理后窗口的网络出口即时切换至新IP，无需重新创建窗口。
• 支持Cookie的导入与导出：通过API可批量导入Cookie到指定窗口，实现无密码登录；也可导出窗口的Cookie用于备份或迁移。支持通过/cookie/import和/cookie/export接口操作。

窗口管理与信息查询

• 支持列出所有窗口信息：通过/browser/list接口获取当前账号下所有已创建的窗口列表，包含窗口ID、名称、分组、指纹配置、代理状态等完整信息，便于自动化脚本进行批量管理。
• 支持窗口状态的实时查询：通过/browser/status接口查询指定窗口的当前状态（运行中/已关闭/异常），以及当前使用的IP地址、窗口标题、URL等信息，便于监控和管理大规模窗口集群的运行情况。
• 支持窗口分组的批量操作：可通过API按分组标签批量查询窗口、批量修改配置或批量关闭窗口。通过/browser/list?group=分组名称筛选特定分组下的所有窗口，实现基于分组的自动化管理。

如何开启和调用Local API？

开启Local API服务

• 在系统设置中开启Local API：打开比特浏览器客户端，点击右上角用户头像旁的箭头图标，进入「系统设置」。在设置面板中找到「Local API」或「本地API」选项，将开关切换为开启状态。开启后客户端会启动本地HTTP服务。
• 确认端口号并检查防火墙：Local API默认端口为54345，可在设置中查看当前端口号。如端口被占用可手动修改。需确保防火墙未拦截该端口的本地通信，否则API调用将无法正常响应。
• Local API仅在客户端运行时提供服务：Local API服务依赖于比特浏览器客户端的运行，关闭客户端后API将不可用。自动化脚本需确保客户端处于运行状态。开发调试阶段可使用Postman发送请求验证服务是否正常响应。

通过编程方式调用Local API

• 发送HTTP请求调用接口：使用Python的requests库、JavaScript的fetch或其他HTTP客户端发送POST请求到http://127.0.0.1:54345/接口路径。所有接口的请求方式为POST，参数传递方式为body传参（JSON格式）。
• 传入正确的参数并解析响应：每个接口需要传入对应的JSON参数，如/browser/update接口需传入name、browserFingerPrint等字段。接口返回统一格式的JSON对象，通过success字段判断操作是否成功，data字段获取返回的数据。
• 注意请求方法的严格限制：Local API只接受POST请求，不接受GET、PUT、DELETE等其他方法。参数只能通过request body传递（JSON格式），不接受query string、form-data或x-www-form-urlencoded格式。建议先用Postman调试确认接口调用成功后再进行脚本开发。

Local API的请求和响应格式是怎样的？

请求格式规范

• 所有接口仅支持POST请求方法：Local API设计为只接受POST请求，不接受GET、PUT、DELETE等其他HTTP方法。使用错误的方法会导致请求被拒绝。
• 参数通过request body传递，格式为JSON：所有接口的参数只能通过请求体（request body）传递，格式为application/json。不接受query string、form-data或x-www-form-urlencoded等格式的传参方式。
• 参数按接口定义规范传递：每个接口有自己独立的参数定义，需按照接口文档中的字段名称和数据类型严格传递。不要随意删改参数或传递未知意义的值，否则可能导致程序出错甚至闪退。

响应格式规范

• 响应为统一的JSON对象：所有接口返回统一格式的JSON对象，包含success、msg、data等字段。success为布尔值，true表示操作成功，false表示业务失败。msg为字符串，包含操作结果或错误描述。data为对象或数组，包含返回的数据。
• 成功时success为true，数据在data字段：当操作成功时，success字段为true，msg通常为“success”或类似信息，具体数据在data字段中返回。例如创建窗口成功后，data中包含browserId字段。
• 失败时success为false，错误信息在msg字段：当操作失败时，success字段为false，msg字段包含具体的错误描述信息，如“参数错误”“端口冲突”“窗口不存在”等。data字段通常为空。开发者应根据success字段判断操作结果，并在失败时根据msg内容进行排查。

Local API与Selenium/Playwright如何集成？

创建窗口并启动供自动化框架连接

• 通过Local API创建指纹隔离的浏览器窗口：首先调用/browser/update接口创建带有独立指纹配置的窗口，传入操作系统、分辨率、时区、Canvas噪音等参数。接口返回的browserId是后续连接操作的关键标识。
• 通过/browser/open接口启动窗口并获取调试地址：调用/browser/open接口传入browserId，启动浏览器窗口。接口返回的data.debuggerAddress字段包含该窗口的调试地址（如127.0.0.1:54345），供Selenium/Playwright连接使用。
• 使用调试地址连接自动化框架：在Selenium或Playwright中配置调试地址，连接到已启动的比特浏览器窗口。连接成功后，即可使用自动化框架的标准API执行登录、点击、填表、数据采集等操作，所有操作均在防关联的指纹环境中执行。

执行自动化操作的完整流程

• 典型集成流程包含三个步骤：首先调用/browser/update创建指纹配置文件，获取browserId。然后调用/browser/open打开窗口，获取debuggerAddress。最后用Selenium/Playwright连接该地址执行自动化操作，操作完成后可调用/browser/close关闭窗口。
• 多个窗口可并行执行自动化任务：通过API批量创建多个窗口，每个窗口拥有独立的指纹和IP环境，为每个窗口获取独立的debuggerAddress，然后在多线程或异步任务中分别连接不同的窗口执行自动化操作。
• 窗口的指纹环境独立且隔离：每个窗口的指纹、Cookie、缓存完全隔离。即使同一自动化框架同时连接多个窗口，各窗口的环境也不会相互干扰。自动化框架调用完成后，可根据需求保留窗口供后续使用或调用/browser/close关闭释放资源。

Local API在自动化操作中有哪些典型应用场景？

批量多账号管理

• 批量创建和配置浏览器环境：使用Local API批量创建大量拥有独立指纹和代理IP的浏览器窗口，每个窗口对应一个独立的账号环境。可用于跨境电商多店铺管理、社媒矩阵账号运营、Web3空投批量操作等场景，大幅减少手动创建和配置环境的时间。
• 批量导入Cookie实现无密码登录：通过/cookie/import接口为批量窗口导入已登录的Cookie，实现无需输入账号密码即可启动窗口并直接进入已登录状态，适用于账号登录状态批量迁移和跨设备恢复场景。
• 批量更新代理IP和指纹参数：当代理IP失效或需要更换运营地区时，可通过Local API批量修改窗口的代理配置和指纹参数，无需逐个手动修改，实现大规模环境的快速切换和调整。

自动化数据采集与测试

• 结合爬虫技术采集公开数据：通过Local API创建带有纯净住宅代理的窗口，配合Selenium/Playwright进行网页数据采集。每个窗口使用独立IP和指纹，避免因请求频率过高被封禁，可安全绕过反爬系统获取电商平台价格、评论、销量等数据。
• 广告投放效果验证与监测：为每个广告账户创建独立指纹环境，通过Local API批量启动窗口，自动化验证广告落地页的显示效果、加载速度和功能完整性，确保广告素材在不同设备和地区的呈现效果符合预期。
• 自动化测试与持续集成集成：在CI/CD流程中，通过Local API按需创建临时测试环境，运行自动化测试套件后自动清理，确保测试环境的独立性和干净性，同时与测试框架（如pytest、JUnit）集成实现自动化回归测试。

与RPA流程深度集成

• 与影刀等RPA平台对接：通过Local API接口，让RPA机器人直接操控比特浏览器窗口，执行商品自动上架、批量加购、自动点赞评论等复杂流程，结合指纹隔离环境实现大规模自动化运营。RPA机器人可精准操作浏览器，响应速度快。
• 实现自动化脚本与浏览器的闭环控制：Local API让开发者可以用程序化方式完整控制比特浏览器的生命周期，包括窗口的创建、配置、启动、操作和销毁。所有操作可被脚本记录和追溯，便于调试、优化和重现自动化流程。

使用Local API时有哪些注意事项？

接口调用规范与限制

• 所有接口仅支持POST请求，参数为JSON格式：Local API不接受GET、PUT等请求方法，也不支持query string或form-data传参。务必使用POST方法并在请求体中传递JSON格式的参数，否则接口将无法正确处理请求。
• 参数按规范传递，不要随意删改：创建或修改窗口时，接口参数必须符合规范，不要随意删改参数或传递未知意义的值或类型，否则可能导致程序出错甚至闪退。参考官方接口文档中的字段定义和示例进行开发。
• 建议先用Postman调试再开发脚本：先用Postman调通接口，确认接口调用成功后再进行脚本开发，避免参数格式错误导致的程序异常。Postman调试文件可从官方渠道获取，包含预配置好的请求示例。

运行环境与客户端状态

• Local API依赖于比特浏览器客户端的运行：Local API服务与比特浏览器客户端绑定，关闭客户端后API将不可用。自动化脚本需确保客户端处于运行状态，建议在脚本中增加客户端状态检测逻辑。
• 同一窗口不要同时进行多重操作：对于同一个窗口，不建议同时进行多重操作，例如一边通过API控制窗口，一边手动操作窗口，可能造成状态冲突或数据错乱。建议在脚本中统一管理所有窗口的操作流程。
• 涉及关键业务时做好错误处理：编写代码时需考虑接口调用失败、窗口打开超时、代理连接失败等异常情况的处理逻辑。建议在关键操作（如创建窗口、导入Cookie）中加入重试机制和日志记录，便于排查定位问题。

Local API接口文档和示例代码在哪里获取？

官方接口文档获取渠道

• 比特浏览器官网提供完整的API文档：访问比特浏览器官网（www.bitbrowser.cn），在导航栏或帮助中心中找到「开发文档」或「API文档」入口。文档包含所有Local API接口的详细介绍，涵盖请求地址、参数说明、返回格式、错误码以及完整的调用示例。
• 建议将文档页面添加到书签方便查阅：开发过程中需要频繁查阅接口定义和参数说明，建议将文档页面加入浏览器书签。文档会跟随客户端版本更新而更新，建议定期查看了解新增接口和功能变化。
• 通过Postman调试文件快速上手：官方提供Postman调试导入文件（.json），包含所有接口的预配置请求示例。导入Postman后可直接发送请求测试接口功能，无需手动构造请求，大幅降低开发调试门槛。

多语言示例代码

• 官方提供JavaScript和Python等多种语言的示例代码：开发文档中包含了Python和JavaScript等多种编程语言的Demo代码，展示如何调用Local API创建、打开、操作和关闭浏览器窗口。开发者可直接参考或复制代码进行二次开发。
• 示例代码覆盖典型的调用流程：示例代码通常包含完整的调用流程，从开启API服务、创建指纹配置、启动窗口、执行操作到关闭窗口。建议先运行示例代码验证本地环境配置正确，再进行个性化开发。
• 可基于示例代码搭建自动化框架：开发者可基于官方示例代码搭建自己的自动化框架，将Local API调用与Selenium/Playwright等自动化工具结合，实现高效的自动化运营方案。遇到问题可通过官方客服或技术社区获取支持。