ProxyCove API
用普通的 HTTP 请求购买和管理代理。无需 SDK,也无需在网站注册:一次请求即可创建账户并获得密钥。
如何开始
获取密钥
一次请求即可得到账户和 pc_live_… 形式的密钥。密钥只显示一次。
充值余额
请求会返回支付链接。付款始终由用户在浏览器中完成。
购买代理
余额到账后,购买接口会直接返回可用的连接信息。
鉴权
密钥通过请求头传递。没有密钥时,只能访问价格、国家列表和创建账户。
Authorization: Bearer pc_live_YOUR_KEY
接口一览
GET/pricing每 GB 价格密钥: 不需要
curl https://proxycove.com/api/v1/pricing
GET/locations可用国家列表密钥: 不需要
type = residential | mobile | datacenter
curl "https://proxycove.com/api/v1/locations?type=residential"
POST/accounts创建账户并获取密钥密钥: 不需要
label, contact_email — 可选
curl -X POST https://proxycove.com/api/v1/accounts \
-H "Content-Type: application/json" \
-d '{"label":"my project"}'GET/account余额与账户信息密钥: 需要
curl https://proxycove.com/api/v1/account -H "Authorization: Bearer pc_live_YOUR_KEY"
POST/topup给用户的充值链接密钥: 需要
amount_usd ≥ 1.5 · method = sbp | card_ru | crypto | card_international | crypto_cryptomus
curl -X POST https://proxycove.com/api/v1/topup \
-H "Authorization: Bearer pc_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"amount_usd":20,"method":"sbp"}'GET/payments/{id}支付状态密钥: 需要
pending | paid | cancelled
curl https://proxycove.com/api/v1/payments/ID -H "Authorization: Bearer pc_live_YOUR_KEY"
POST/proxies购买代理密钥: 需要
type · country (ISO-3166 alpha-2) · traffic_gb 1–1000 · rotation.interval_minutes 1–120
curl -X POST https://proxycove.com/api/v1/proxies \
-H "Authorization: Bearer pc_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"residential","country":"de","traffic_gb":5,
"rotation":{"interval_minutes":10}}'GET/proxies所有代理及剩余流量密钥: 需要
curl https://proxycove.com/api/v1/proxies -H "Authorization: Bearer pc_live_YOUR_KEY"
GET/proxies/{id}/credentials连接字符串密钥: 需要
curl https://proxycove.com/api/v1/proxies/ID/credentials -H "Authorization: Bearer pc_live_YOUR_KEY"
POST/proxies/{id}/extend追加流量密钥: 需要
traffic_gb 1–1000
curl -X POST https://proxycove.com/api/v1/proxies/ID/extend \
-H "Authorization: Bearer pc_live_YOUR_KEY" \
-H "Content-Type: application/json" -d '{"traffic_gb":5}'GET/proxies/{id}/usage流量消耗密钥: 需要
curl https://proxycove.com/api/v1/proxies/ID/usage -H "Authorization: Bearer pc_live_YOUR_KEY"
POST/proxies/{id}/rotation更改 IP 轮换方式密钥: 需要
mode: "every_request" | interval_minutes: 1–120
curl -X POST https://proxycove.com/api/v1/proxies/ID/rotation \
-H "Authorization: Bearer pc_live_YOUR_KEY" \
-H "Content-Type: application/json" -d '{"interval_minutes":10}'POST/account/link-telegramTelegram 绑定码密钥: 需要
验证码有效期 30 分钟
curl -X POST https://proxycove.com/api/v1/account/link-telegram -H "Authorization: Bearer pc_live_YOUR_KEY"
POST/account/recovery绑定找回邮箱密钥: 需要
email — 确认邮件每小时最多一封
curl -X POST https://proxycove.com/api/v1/account/recovery \
-H "Authorization: Bearer pc_live_YOUR_KEY" \
-H "Content-Type: application/json" -d '{"email":"[email protected]"}'如何连接已购买的代理
所有代理都在 go.proxycove.com 上响应,端口决定轮换方式:
824每次请求更换 IP10000IP 保持设定的 1–120 分钟http://LOGIN:[email protected]:824
购买后请等待约 5 秒再发出第一个请求:上游供应商的国家过滤需要片刻才会生效。
错误与限制
400请求参数有误401缺少密钥,或密钥无效、已吊销403账户被封禁404对象不存在或属于其他账户429请求过于频繁,Retry-After 头会告知等待时长502支付服务商错误限制:每个密钥每分钟 60 次请求,每个地址每分钟 120 次;每个地址每小时创建 20 个账户;请求体最大 32 KB。
机器可读的规范
完整的 OpenAPI 规范,客户端生成器与 AI 智能体均可识别:
https://proxycove.com/api/v1/openapi.json
在使用 AI 智能体?
那就不需要 HTTP:我们提供现成的 MCP 服务器,一行配置即可接入 Claude、ChatGPT、Cursor 等。 https://proxycove.com/zh/ai-agents/