API 文档与指南
完整的接口文档、SDK 支持、快速开始指南
快速开始
1
获取 API Key
在账户设置中生成你的 API 密钥
2
阅读文档
查看 API 接口文档和代码示例
3
集成调用
使用 SDK 或 HTTP 请求集成到你的应用
主要 API 端点
GET
/api/proxy/get获取代理 IP
参数: num, city, isp, type, protocol
GET
/api/account/balance查询账户余额
参数: 无
GET
/api/orders/list获取订单列表
参数: page, limit
GET
/api/statistics/usage查询使用统计
参数: start_date, end_date
代码示例
JavaScript / Node.js
const fetch = require('node-fetch');
const response = await fetch('https://api.oneproxy.com/api/proxy/get', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
query: {
num: 10, // IP 数量
city: 'beijing', // 城市
isp: 'telecom', // 运营商
type: 'dynamic', // IP 类型
protocol: 'http' // 协议
}
});
const data = await response.json();
console.log(data.ips);Python
import requests
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
params = {
'num': 10,
'city': 'beijing',
'isp': 'telecom',
'type': 'dynamic',
'protocol': 'http'
}
response = requests.get(
'https://api.oneproxy.com/api/proxy/get',
headers=headers,
params=params
)
data = response.json()
print(data['ips'])SDK 支持
JavaScript SDK已发布
Python SDK已发布
PHP SDK已发布
Java SDK开发中
Go SDK开发中
Ruby SDK规划中
常见问题
API 速率限制是多少？
免费账户：100 请求/分钟；企业账户：无限制。
如何处理 API 错误？
所有错误都会返回相应的 HTTP 状态码和错误信息，详见错误代码文档。
IP 是否支持轮换？
是的，动态 IP 每次请求都会更换；静态 IP 在有效期内保持不变。
是否提供 IP 白名单？
支持，你可以在账户设置中配置 IP 白名单以增强安全性。