9Proxy 控制面板是你进行精细手动操作的指挥中心，但当你的业务规模发展到一定程度时，手动操作已无法满足需求。9Proxy 公共 API 将完整的程序化控制权直接交到你的系统手中，把手动任务转变为自动化工作流程。
这不仅仅是一次功能更新，而是一种全新的运作方式。
公共 API 实际能做什么
从本质上讲，9Proxy 公共 API 是与你的 9Proxy 系统进行直接通信的协议。通过 API 密钥完成身份验证后，你原本需要在控制面板中执行的每一个操作，都可以转化为 API 调用，并且可以从任何地方触发、调度或自动化，无需任何中间工具。
具体包括：
- 账户管理：通过程序查询你的实时余额、购买记录和使用日志
- 子账户操作：无需进入 UI，即可批量创建和管理子账户
- 分享码管理：在你自己的工作流程中生成或撤销分享码
- 钱包与计费：直接从系统中查看交易记录
- 联盟追踪：无需手动导出即可获取佣金数据和推广表现
- 实时代理统计：将 IP 使用情况和带宽消耗接入你自己的监控系统
在实际应用中，这意味着你的系统可以直接与 9Proxy 通信，无需访问控制面板、无需手动操作，也无需人工参与整个流程。
9Proxy 公共 API 的端点、访问与身份验证
所有 API 调用都通过统一的生产环境基础域名进行：api.9proxy.com — 这是用于真实流量和实际账户操作的正式接口。所有 API 密钥都会继承你账户的完整权限，这意味着从生成密钥的那一刻起，你就可以访问所有已支持的 API 端点。
9Proxy 公共 API 包含以下端点分组：
- 账户 API — 查询余额、使用日志和账户元数据
- 子账户 API — 通过程序创建、管理和监控子账户
- 分享码 API — 批量生成和撤销代理分享码
- 用户名/密码 API — 管理身份验证凭据（用户名和密码）
- 白名单 API — 无需进入控制面板即可管理 IP 白名单
- 计费 API — 查询钱包状态和交易记录
- 联盟 API — 获取佣金追踪和推荐数据
- 代理连接配置 API — 以程序化方式创建和管理代理白名单连接配置
每个端点分组的完整文档可以在 9Proxy 公共 API 参考文档中查看。
适用人群
简而言之：任何在代理使用规模上手动操作已成为瓶颈的人。
开发者构建内部工具。如果你的团队运行自己的代理管理界面 – 无论是爬虫调度平台、客户定制管理面板，还是内部运维仪表盘 – 公共 API 都是将前端与 9Proxy 后端连接的桥梁。实时余额可视化、使用情况细分、子账户配置：所有数据都通过 API 调用直接传入你的界面。
管理多客户的代理机构。手动创建子账户、分发分享码以及拉取每个客户的使用报告，当规模扩大时无法支撑。通过 API 驱动的子账户管理和分享码生成，新增客户或轮换凭据只需调用函数，而不是执行复杂工作流程。
运行大规模爬虫或数据采集的自动化工程师。当代理轮换逻辑、会话管理和使用监控都在你自己的系统中时，最不希望出现的就是中间有人工操作。将 9Proxy API 集成到你的爬虫调度系统中，基础设施就能自我管理 – 你定义逻辑一次，它就能自动运行。
需要实时可视化但不依赖控制面板的团队。通过 API 拉取实时 IP 统计和带宽消耗，让你可以在任何需要的地方呈现数据：Grafana、定制 Slack 机器人、使用警报系统，或者你的监控系统中任何其他组件。无需等待浏览器标签页确认是否资源即将耗尽。
如何生成并保护你的 API 密钥
- 生成 API 密钥：在 9Proxy 控制面板中，进入 我的账户 → API Key。在此选项出现前，你需要启用双重验证（2FA）并完成账户验证。
- 安全存储至关重要：点击 生成密钥 后，立即复制并存储在安全位置（如密码管理器）。为了最大安全性，API 密钥只会显示一次。9Proxy 在生成后不会存储完整密钥。如果在保存前关闭窗口，你需要撤销旧密钥并生成新密钥。
- 选择环境：在集成准备就绪后，生产环境请使用 api.9proxy.com。
- 密钥轮换与安全：如果怀疑密钥被泄露，可使用 撤销并重新生成 功能。
对开发者而言，重新生成密钥会立即使旧密钥失效。任何使用旧密钥的脚本、工具或生产集成都将立即失效，直到更新为新密钥。建议在维护窗口期间进行密钥轮换，以避免服务中断。
有关密钥生成和轮换的完整说明，请参阅 生成你的 API 密钥指南。如果你对密钥的可见性、权限或重新生成后的情况有疑问，常见问题（FAQ）部分涵盖了最常见的问题。
运营模式的转变
代理管理 API 的真正价值不在于某一个单独的端点，而在于从被动操作向自动化运营的转变。
没有 API 访问权限时，大规模管理代理基础设施意味着持续的手动干预：在活动开始前检查余额、逐一创建子账户、手动提取使用数据、通过 UI 撤销分享码。每个操作看似微小，但累积起来会对执行这些操作的人造成显著负担。
使用公共 API 后，这些操作就成为系统逻辑的一部分：新客户入驻时自动配置子账户；余额超过阈值时触发提醒；使用报告按计划生成并送达所需位置；分享码按你设定的时间自动轮换。
基础设施没有改变，但运营负担大幅降低。
