OwlProxy API
  • 简体中文
  • English
  • 简体中文
  • English
  • 产品介绍
  • 产品类型
  • 产品计费
  • OpenAPI
    • 接口文档
    • 调用说明
    • 更新记录
    • LLMs.txt(AI快速参考)
    • OpenAPI 规范(AI 专用)
    • 错误码

OwlProxy OpenAPI 开发者速查手册

OwlProxy 代理服务 OpenAPI 接口快速参考 · 适合 AI 工具直接读取

本文档为 AI 快速参考:供大模型、代码助手等工具快速解析接口路径、方法及用途。详细请求/响应参数、示例以 接口文档 为准。

📥 下载纯文本版本 — 适合 AI 工具直接读取

获取方式:

  • 浏览器下载:点击此处下载 llms-ai-reference.txt,或访问 https://api.owlproxy.com/owlproxy/doc/zh/server/llms-ai-reference.txt
  • 命令行获取:curl https://api.owlproxy.com/owlproxy/doc/zh/server/llms-ai-reference.txt -o owlproxy-api.txt
  • 在线预览:浏览器中打开上述链接可查看原始文本(如遇乱码请设置编码为 UTF-8)

🔐 认证方式(必读)

认证说明

本 API 使用 HMAC-SHA256 签名验证。

请求头设置(每个请求必需)

请求头说明示例值
x-date请求 UTC 时间,ISO 8601 格式20240301T093700Z
x-host接口访问域名api.owlproxy.com
Content-Type资源 MIME 类型application/json
authorizationHMAC-SHA256 签名见 调用说明

Authorization 格式

HMAC-SHA256 Credential={AccessKey}, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature={Signature}

签名计算步骤(规范请求、待签名字符串、SigningKey、Signature)及示例代码请参考 接口文档。


📡 基础信息

配置项值
接口域名https://api.owlproxy.com
路径前缀/owlproxy/(部分接口)
响应格式JSON { code, msg, ts, data }
成功状态码code=200

📚 API 功能分类

1️⃣ 静态IP服务

接口方法路径说明
获取代理类型GET/owlproxy/proxy/type获取支持的代理类型列表
获取静态IP地区GET/owlproxy/static/region获取静态IP支持的地区列表
获取静态IP质量选项GET/owlproxy/static/quality获取静态IP质量选项
获取静态IP服务商GET/owlproxy/static/provider获取静态IP服务商列表
获取静态IP套餐GET/owlproxy/static/package获取静态IP套餐列表
购买静态IP套餐POST/owlproxy/static/order购买静态IP套餐
根据订单号获取IP信息POST/owlproxy/static/ipinfo根据订单号获取IP信息
获取静态IP列表POST/owlproxy/static/list获取用户静态IP列表
修改静态IP备注POST/owlproxy/static/remark修改静态IP备注
静态IP续费POST/owlproxy/static/renew静态IP续费
批量计算续费价格POST/openApi/vcProxy/batchCalculateRenewPrice批量计算多个IP的续费价格
设置静态IP自动续费POST/owlproxy/static/autoRenew设置静态IP自动续费
静态IP订单列表POST/owlproxy/static/orderList获取静态IP订单列表

2️⃣ 动态代理服务

接口方法路径说明
查询动态流量余额GET/owlproxy/dynamic/balance查询动态代理当前流量余额
获取动态IP套餐GET/owlproxy/dynamic/package获取动态IP套餐列表
购买动态IP套餐POST/owlproxy/dynamic/order购买动态IP套餐
获取动态IP提取地区GET/owlproxy/dynamic/region获取动态IP提取地区列表
获取动态IP提取线路GET/owlproxy/dynamic/line获取动态IP提取线路
动态IP提取POST/owlproxy/dynamic/extract提取动态IP
动态IP自动续费订单POST/owlproxy/dynamic/autoRenewOrder获取动态IP自动续费订单
动态IP设置自动续费POST/owlproxy/dynamic/setAutoRenew设置动态IP自动续费
动态IP订单列表POST/owlproxy/dynamic/orderList获取动态IP订单列表

3️⃣ 回调管理

接口方法路径说明
购买和续费静态IP套餐支付结果回调POST回调地址支付结果回调通知

回调需在 WEB 端配置回调地址,详细字段与示例见 接口文档。


📋 回调通知事件

事件说明
静态IP购买成功回调支付成功后触发回调,通知订单状态变更
静态IP续费成功回调续费支付成功后触发回调

🚦 常见错误码

错误码说明处理建议
200成功-
2031无效的密钥检查 AK/SK
2032请求头缺少 Authorization补充签名请求头
2019验证签名失败按 接口文档 核对签名
100000请求参数不正确检查参数是否符合要求
100003缺少请求头 Authorization检查请求头
100004无效的签名检查签名计算
100005验证签名失败确认签名方式正确

更多错误码见 错误码说明。


💡 使用建议

提示

  1. 认证安全:妥善保管 AK/SK,勿在客户端硬编码,定期更换。
  2. IP提取:动态IP提取后请及时使用,IP存在有效期限制。
  3. 套餐选择:根据业务需求选择合适的套餐类型和地区。
  4. 回调配置:建议配置回调地址以获取订单状态变更通知。
  5. 流量监控:定期查询流量余额,避免服务中断。

📖 相关文档

相关信息

文档说明
接口文档完整接口说明、请求/响应参数及示例
错误码说明系统错误码与解决方案
回调接口回调类型与示例 JSON

文档版本:速查版
内容以 OpenAPI 接口文档 为准

Prev
更新记录
Next
OpenAPI 规范(AI 专用)