简体中文 
English
Español
Português
Deutsch
Français
Русский
Türkçe
Polski
Tiếng Việt
한국어
Nederlands
Italiano
日本語
Eesti
Čeština
Bahasa Melayu
हिन्दी
Bahasa Indonesia
العربية
REST · OpenAPI 3.1
将 FineProxy 集成到您的应用程序中
从后端、脚本、CI 任务、内部面板或无代码工作流程调用已有文档的 HTTP 端点。当前客户端规范可在控制面板中获取。
适合您的代码需要：- 无需 AI 模型即可运行确定性的工作流程
- 依据 OpenAPI 验证请求和响应结构
- 自行控制重试、队列、日志和部署
开发者平台
FineProxy API 与 MCP
通过代码自动执行代理操作，或连接 AI 智能体。了解支持的功能、安全保障适用范围，以及在更换提供商前如何审计现有集成。
一个平台，两种自动化方式
API 和 MCP 使用相同的 FineProxy 权限范围密钥，并开放相同的客户工作流程。请根据操作者进行选择：您的应用程序或 AI 智能体。
JSON-RPC 2.0 · Streamable HTTP
向 AI 智能体授予受控访问权限
将 Cursor、Claude、VS Code、Cline、n8n 或其他 MCP 客户端连接到 FineProxy 服务器。智能体将获得 API 密钥权限范围所允许的工具。
适合您希望智能体：- 检查库存、服务、使用情况和支持记录
- 为服务操作报价并执行已批准的操作
- 诊断故障并说明建议的变更
迁移前审计现有集成
下载一个 Markdown 文件，将它与代码仓库一并提供给编码智能体，然后运行准备好的审计提示词。首次审计仅进行只读检查：识别兼容性、适配器、阻碍因素，以及需要更改的确切代码。
只读迁移审计提示词
阅读所附的 FineProxy Agent Pack，并检查此代码仓库。
首次检查期间请勿修改代码。
找出当前代理提供商的所有配置或调用位置。将每个工作流程与 FineProxy 文档中说明的功能进行比较。报告：
1. 完全兼容的工作流程。
2. 需要适配器或数据转换的工作流程。
3. 不受支持或尚不明确的行为。
4. 所需的 FineProxy API 权限。
5. 将会更改的确切文件和代码路径。
6. 身份验证和机密存储方面的变更。
7. 包含回滚方案的分阶段迁移计划。
8. 切换前所需的集成测试。
不要虚构端点。凡是未获 Agent Pack 或当前 OpenAPI 规范确认的内容，均标记为待确认问题。审计应验证
- 01当前提供商的初始化和调用位置
- 02身份验证和机密存储方面的差异
- 03服务购买、续订、取消和 IP 更新流程
- 04代理列表格式、协议、端口和身份验证方式
- 05国家/地区选择、允许列表和连接限制
- 06分页、重试、幂等性、错误和速率处理
- 07账单、使用情况分析、支持和 Webhook 依赖项
- 08不编辑代码的逐文件迁移与测试计划
如需进行端点级实现，还应向智能体提供从控制面板下载的当前 OpenAPI 文件。Agent Pack 特意不包含任何凭据或私有账户数据。
可实现哪些自动化
公开页面说明完整的工作流程，而不是逐一复述每个端点。实现具体请求时，请使用实时 OpenAPI 规范。
购买与配置
查询实时库存、计算精确的国家/地区组合，并使用控制面板钱包下单。
- 列出可用国家/地区和当前 IP 库存
- 在不支付资金的情况下为多国家/地区套餐报价
- 使用价格保护和幂等键购买
服务管理
如果套餐支持所请求的操作，无需等待支持工单即可管理有效服务。
- 续订、暂停、恢复或取消服务
- 更换或添加 IP，并更新凭据
- 管理自动续订、允许列表和连接附加项
分析与诊断
使用账户和服务遥测数据调查负载、可靠性及目标地址行为。
- 读取使用情况概览和时间序列
- 检查主要目标地址和错误类别
- 获取诊断结果和运维建议
账单与支持
将代理操作与其相关的财务及支持工作流程相连接。
- 读取账单并下载账单 PDF
- 发起钱包充值并检查其状态
- 创建、读取、回复和关闭支持工单
代理访问
获取应用程序通过已购代理建立连接所需的设置。
- 读取轮换代理连接配置
- 更改服务登录名和密码
- 管理允许列表中每个 IP 的连接限制
事件与账户
保持外部系统同步，并检查与安全相关的账户信息。
- 配置 Webhook 和交付处理
- 读取个人资料数据、调用方 IP 和登录历史记录
- 使用精细选择的权限管理 API 密钥
平台不会执行的操作
FineProxy 自动化有意设置了明确边界。访问权限由密钥、服务套餐、实时库存和显式安全检查共同决定。
无法访问授权范围以外的内容
除非 API 密钥包含所需权限，否则工具或端点无法读取或更改资源。
没有 wallet:spend 权限就无法支出
缺少财务权限范围时，购买、续订和付费 IP 更新均不可用。
不会静默执行破坏性操作
不可逆操作需要显式确认标志，不能作为读取请求的副作用发生。
无法通过 MCP 访问源代码
FineProxy MCP 用于操作客户账户。如需审计脚本，还必须向编码智能体授予该脚本或代码仓库的访问权限。
不保证提供无库存支持的资源
国家/地区可用性和数量以实时库存为准。自动化程序无法订购当前没有库存的资源。
非有效合作伙伴无法使用合作伙伴 API
只有账户具备有效合作伙伴状态时，才会显示合作伙伴规范和报告端点。
几分钟内连接智能体
在控制面板中创建专用 API 密钥，仅选择智能体所需的权限范围，然后将 MCP 配置放入客户端。请将真实密钥保存在机密存储或环境变量中。
mcp.json
{
"mcpServers": {
"fineproxy": {
"url": "https://fineproxy.org/account_new/api/v1/mcp",
"headers": {
"Authorization": "Bearer fb_YOUR_API_KEY"
}
}
}
}OpenAPI 3.1
使用实时规范进行实现
控制面板会呈现经过整理的客户端 OpenAPI 3.1 规范、请求示例、响应架构和生成的客户端代码片段。有效合作伙伴还可获得单独的合作伙伴规范。
查看交互式 API 参考选择最小且实用的权限集
读取权限与写入权限相互独立。探索和迁移审计时先使用只读权限范围，随后仅向确实需要的工作流程添加写入或财务权限。
值得保留的默认安全措施
- 为每个应用程序或智能体创建单独的 API 密钥，以便独立撤销。
- 使用只读权限范围开始审计。仅在审核提议的计划后，才添加 services:write 或 wallet:spend。
- 将密钥存储在环境变量或机密管理器中，绝不要放入源代码、提示词、截图或已提交的 MCP 配置。
- 购买时使用报价中的预期总额。价格发生变化时操作会被拒绝，而不会静默收取更多费用。
- 重试超时的财务请求时复用幂等键，避免同一操作被重复扣费。
- 在将事件纳入关键工作流程前，检查 Webhook 签名和交付历史记录。