/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 }
]
}🎁 每个新账户可免费试用 12 小时 · 🇩🇪 真实德国 4G 运营商 IP · ♾️ 不限流量 · 无限轮换 · ₿ 支持加密货币或银行卡付款
以编程方式购买、轮换和管理德国 4G 代理。小巧、可预期的 REST API —— JSON 进,JSON 出。
https://api.proxion.io/v1所有接口均在 /v1 下版本化,仅通过 HTTPS 提供。
每个请求都要在 Authorization 请求头中携带 API 密钥。在控制台的「API 密钥」中创建和撤销密钥。密钥是机密 —— 切勿暴露在客户端代码中。
Authorization: Bearer prx_live_xxx测试密钥(prx_test_…)创建的代理行为完全相同,但从不计费。
整个 API 遵循几条一致的规则,调用过一个接口就了解了全部。
请求和响应体均为 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;窗口重置后重试。
购买代理会返回一个代理对象。这是你唯一需要操作的资源 —— 除非轮换,否则其凭据不会改变。
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 唯一标识,例如 px_a1b2c3d4。 |
plan | string | 1d、7d、30d 之一(或 trial)。 |
status | string | 可用时为 active,到期后为 expired,提前结束为 released。 |
host | string | 代理主机名,例如 de1.proxion.io。 |
port | integer | HTTP 和 SOCKS5 共用的代理端口。 |
username | string | 用户名:密码认证的用户名。 |
password | string | 用户名:密码认证的密码。 |
protocols | string[] | 支持的协议:["http", "socks5"]。 |
country | string | ISO 国家代码 —— 始终为 DE。 |
os_profile | string | TCP 指纹配置:none、windows、macos、android、ios 或 linux。 |
allowed_ips | string[] | 无需用户名:密码即可访问的 IP / CIDR 网段(最多 20 个)。 |
created_at | string | 代理开通时间。 |
expires_at | string | 访问结束、IP 释放的时间。 |
八个接口覆盖完整生命周期:查看套餐、购买代理、查询、轮换 IP、更改设置、续期以及提前释放。
/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 }
]
}/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"
}/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
}/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"
}/v1/proxies/{id}/rotate为代理分配新的移动 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"
}/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"
}/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"]
}/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 客户端中使用返回的主机、端口、用户名和密码。同一组凭据适用于两种协议。
# 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 天代理并通过它发出第一个请求。
# 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