🎁 每个新账户可免费试用 12 小时 · 🇩🇪 真实德国 4G 运营商 IP · ♾️ 不限流量 · 无限轮换 · ₿ 支持加密货币或银行卡付款

API 参考

以编程方式购买、轮换和管理德国 4G 代理。小巧、可预期的 REST API —— JSON 进,JSON 出。

基础 URLhttps://api.proxion.io/v1

所有接口均在 /v1 下版本化,仅通过 HTTPS 提供。

认证

每个请求都要在 Authorization 请求头中携带 API 密钥。在控制台的「API 密钥」中创建和撤销密钥。密钥是机密 —— 切勿暴露在客户端代码中。

http
Authorization: Bearer prx_live_xxx

测试密钥(prx_test_…)创建的代理行为完全相同,但从不计费。

约定

整个 API 遵循几条一致的规则,调用过一个接口就了解了全部。

全部使用 JSON

请求和响应体均为 UTF-8 JSON。时间戳为 UTC 的 ISO-8601 格式(例如 2026-07-22T10:00:00Z)。

可预期的错误

失败使用标准 HTTP 状态码,并返回 { "error": { "code", "message" } }。code 稳定,可用于判断分支;message 供人阅读。

游标分页

列表接口接受 limit(1–100)和 starting_after=<id>,返回 { "data": [...], "has_more": bool }。

速率限制

每个已认证的响应都带有 X-RateLimit-Limit 和 X-RateLimit-Remaining —— 每个密钥每分钟 120 次请求。超出限制返回 429 和 Retry-After;窗口重置后重试。

代理对象

购买代理会返回一个代理对象。这是你唯一需要操作的资源 —— 除非轮换,否则其凭据不会改变。

字段类型说明
idstring唯一标识,例如 px_a1b2c3d4。
planstring1d、7d、30d 之一(或 trial)。
statusstring可用时为 active,到期后为 expired,提前结束为 released。
hoststring代理主机名,例如 de1.proxion.io。
portintegerHTTP 和 SOCKS5 共用的代理端口。
usernamestring用户名:密码认证的用户名。
passwordstring用户名:密码认证的密码。
protocolsstring[]支持的协议:["http", "socks5"]。
countrystringISO 国家代码 —— 始终为 DE。
os_profilestringTCP 指纹配置:none、windows、macos、android、ios 或 linux。
allowed_ipsstring[]无需用户名:密码即可访问的 IP / CIDR 网段(最多 20 个)。
created_atstring代理开通时间。
expires_atstring访问结束、IP 释放的时间。

接口

八个接口覆盖完整生命周期:查看套餐、购买代理、查询、轮换 IP、更改设置、续期以及提前释放。

GET/v1/plans

列出套餐

返回可用时长及其价格(单位:分)。无需认证。

请求
curl https://api.proxion.io/v1/plans
响应
{
  "data": [
    { "plan": "1d",  "price_cents": 600  },
    { "plan": "7d",  "price_cents": 2900 },
    { "plan": "30d", "price_cents": 7900 }
  ]
}
POST/v1/proxies

购买代理

按指定套餐开通一个新的德国 4G 代理,并返回带凭据的代理,立即可用。请求体:{ "plan": "7d" }。

请求
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
响应
{
  "id": "px_a1b2c3d4",
  "plan": "7d",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4",
  "protocols": ["http", "socks5"],
  "country": "DE",
  "os_profile": "none",
  "allowed_ips": [],
  "created_at": "2026-07-22T10:00:00Z",
  "expires_at": "2026-07-29T10:00:00Z"
}
GET/v1/proxies

列出你的代理

返回你的代理,最新的在前。可用 ?status=active|expired 过滤,用 limit / starting_after 分页。

请求
curl "https://api.proxion.io/v1/proxies?status=active&limit=20" \
  -H "Authorization: Bearer prx_live_xxx"
响应
{
  "data": [ { "id": "px_a1b2c3d4", "status": "active", "...": "..." } ],
  "has_more": false
}
GET/v1/proxies/{id}

获取代理

按 id 获取单个代理,包括当前凭据和到期时间。

请求
curl https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
响应
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "expires_at": "2026-07-29T10:00:00Z"
}
POST/v1/proxies/{id}/rotate

轮换 IP

为代理分配新的移动 IP,凭据保持不变。若想保留当前 IP,持续连接即可。

请求
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/rotate \
  -H "Authorization: Bearer prx_live_xxx"
响应
{
  "id": "px_a1b2c3d4",
  "host": "de3.proxion.io",
  "port": 28104,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4"
}
POST/v1/proxies/{id}/extend

续期代理

为活跃代理增加一个周期,使其在原到期后继续保持相同的 IP 和凭据。请求体:{ "plan": "7d" }。

请求
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/extend \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
响应
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "expires_at": "2026-08-05T10:00:00Z"
}
PATCH/v1/proxies/{id}

更新设置

设置 TCP 操作系统指纹配置(none、windows、macos、android、ios、linux)和/或 IP 白名单。未提供的字段保持不变;allowed_ips 会替换整个列表。

请求
curl -X PATCH https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx" \
  -d '{ "os_profile": "windows", "allowed_ips": ["203.0.113.7", "10.0.0.0/24"] }'
响应
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "os_profile": "windows",
  "allowed_ips": ["203.0.113.7", "10.0.0.0/24"]
}
DELETE/v1/proxies/{id}

释放代理

提前结束代理并释放其 IP。不可撤销;剩余时间不退款。

请求
curl -X DELETE https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
响应
{
  "id": "px_a1b2c3d4",
  "status": "released"
}

连接到代理

在任意 HTTP 或 SOCKS5 客户端中使用返回的主机、端口、用户名和密码。同一组凭据适用于两种协议。

bash
# HTTP
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org
# → 185.XX.XX.XX (DE · 4G)

# SOCKS5
curl -x socks5://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org

快速开始

两次调用即可购买一个 7 天代理并通过它发出第一个请求。

bash
# 1. Buy a 7-day proxy
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -d '{ "plan": "7d" }'

# 2. Route a request through it
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org
联系我们