赢取 1 TB 住宅流量、 iPhone 18 Pro + 另外 33 份奖品充值 $50 = 1 张抽奖券参加抽奖
企业

如何通过编程购买代理:Proxy Shop API 基础设施扩展指南

扩展您的 数据操作 在地址池半夜耗尽之前一切运行完美。您的爬虫遭遇错误墙。整个管道停止运行。必须有人醒来,登录仪表板,手动点击菜单来租用新端口。手动基础设施管理在高负载下会崩溃。

您需要用代码来解决这个问题。您需要代理商店 API。

简而言之:编程式代理购买

  • 无需登录 Web 界面即可即时扩展您的网络资源。

  • 代理商店 API 让您的脚本自动购买和续订 IP。

  • 将 JSON 负载直接集成到您的部署管道中。

  • 为您的自主 AI 代理 准备 x402 支付协议。

手动基础设施的瓶颈

管理数千个请求需要持续的高信任度地址流。手动购买数十个移动或住宅端口会浪费宝贵的工作时间。它会导致随机系统错误。当目标站点 过滤您的连接时,它还使即时响应变得不可能。

当一个地址失效时,整个流程都在等待人工处理。但您的代码不会休眠。

👉 购买专用移动代理(4G / 5G / LTE)

使用代理商店 API 实现基础设施即代码

将您的网络层视为可编程资源。使用代理商店 API 将 CyberYozh 转变为自动化代理基础设施平台。工程师将代理配置 API 直接嵌入到他们的 CI/CD 管道、Node.js 脚本或 Python 自动化中。

要以编程方式扩展代理基础设施,您的代码只需在目标站点标记您当前 IP 时购买数 GB 的住宅流量或租用新的私有 LTE/5G 端口。

👉 选择静态住宅 IP(ISP)

身份验证和核心端点

REST API 代理购买需要安全连接。正确的 API 密钥管理始于在您的 CyberYozh 面板中生成密钥。

CyberYozh App dashboard section for generating and revoking programmatic access API keys
Token management interface. Generate your unique key before sending any proxy shop requests. You pass it directly in the headers for secure authentication.

Bearer token 代理身份验证是行业标准,可防止以明文发送凭据,从而保护您的基础设施安全。在每个 cURL 请求或 HTTP POST 端点调用的标头中传递此令牌。

bash
curl -X 'GET' \

  'https://app.cyberyozh.com/api/v1/proxies/shop/?country=us&proxy_category=datacenter' \

  -H 'accept: application/json' \

  -H 'X-Api-Key: your_api_key_here'

服务器通过这些特定端点处理请求,以提供完整的代理配置 API:

  • /v2/users/balance/ (GET)。在发起订单之前检查您当前的账户余额,以确保资金充足。

  • /proxies/shop/ (GET)。获取可用地理位置、ASN 和产品类别的动态列表。

  • /proxies/shop/buy_proxies/ (POST)。接受您的 JSON 负载以立即租用基础设施。

👉 租用高速数据中心代理

如何使用 REST API 购买代理并找到正确的参数

编程式代理配置从发送一个项目数组开始。构建 JSON 负载代理订单可以让您独立配置每个端口。

id 保存产品的特定 UUID。您可以通过向 /proxies/shop/发送初始 GET 请求来获取此标识符。

不要拉取整个目录。直接通过查询参数过滤输出。使用 country限制位置。使用 proxy_category (datacenter、 lte、 residential_rotating、 residential_static) 定义网络类型。通过 access_type (shared 或 private) 选择端口隐私级别。通过设置 stock_status=in_stock排除售罄项目。

bash
curl -X 'GET' \

  'https://app.cyberyozh.com/api/v1/proxies/shop/?country=us&proxy_category=datacenter&access_type=private&stock_status=in_stock' \

  -H 'accept: application/json' \

  -H 'X-Api-Key: your_api_key_here'

从服务器响应中复制正确的 id 后,您可以使用 quantity 定义端口数量,使用 period_months定义租用时间。

promo_code 字段应用您的折扣。

将 auto_renew 标志设置为 true 可触发自动代理续费 API。

这本质上为您提供了一个完整的代理订阅管理 API,可在无需手动跟踪的情况下保留高信任度地址。技术参考文档中提供了所有支持变量和服务器响应格式的完整说明。

👉 阅读 Proxy Shop API 文档

bash
[
  {
    "id": "f3e3ec3b-e6eb-40a7-b2d2-9125acb3093c",
    "auto_renew": false,
    "quantity": 2,
    "period_months": 3
  }
]

服务器会即时计算价格,并从您的余额中扣除资金。如果您的资金不足,订单会立即获得已取消状态。

👉 查看我们的代理目录

监控 IP 信誉并自动替换

设想一个处理隔离数字配置文件的大规模操作。脚本使用内部检查器 API 定期检查其当前静态地址的 欺诈分数。在高负载期间,服务器可能会返回状态码 429 请求过多。您的代码使用指数退避处理此速率限制,以便稍后重试调用。一旦 IP 进入黑名单,错误处理程序会将其丢弃并触发 shop API 购买一个干净的静态住宅地址。

bash
import requests

# 1. Check current static IP reputation

check_response = requests.post(
    'https://app.cyberyozh.com/api/v1/checkers/socks/',
    headers={'X-Api-Key': 'your_api_key'},
    json={"ips": ["198.51.100.14"]}
)

# 2. If the IP is compromised, buy a new static proxy immediately

order_response = requests.post(
    'https://app.cyberyozh.com/api/v1/proxies/shop/buy_proxies/',
    headers={'X-Api-Key': 'your_api_key'},
    json=[{
        "id": "f3e3ec3b-e6eb-40a7-b2d2-9125acb3093c",
        "quantity": 1,
        "period_months": 1
    }]
)

服务器会在几秒钟内返回新凭据。系统无需人工干预即可恢复工作。

⚠️

重要架构说明:

此购买流程严格适用于 静态 住宅或数据中心代理。如果您依赖轮换住宅代理,在面临限制时永远不需要购买新产品。网络池已包含 195 个国家的 1 亿个 IP。您只需向 /proxies/rotating-credentials/ 端点发送 POST 请求,并附上您的目标 country_code 和 session_type,即可立即获得新的连接字符串。

👉 访问全球轮换住宅代理

自主代理和 x402 协议

标准计费为自主 AI 代理造成了重大障碍。它们会产生不可预测的流量。机器人无法通过登录屏幕上的手动 CAPTCHA 验证来充值法币余额。

集成 proxy shop API 可为您的技术栈做好机器商务准备。当代理遇到余额为空时,服务器会抛出 HTTP 402 Payment Required 状态。

您的代码必须成功处理 HTTP 402 错误才能解锁 x402 自主支付。代理从标头读取确切成本,签署加密货币交易,并将加密证明发送回服务器。服务器验证后会立即返回专用 IP 的新连接凭据。这种自主代理计费设置可即时处理您的基础设施计费,完全消除了手动法币充值的需求。

关于 proxy shop API 的常见问题

一次请求可以购买多少个代理?

每次 API 调用最多可订购 50 个项目。这使服务器响应时间保持极快。

proxy shop API 如何处理资金不足?

服务器返回带有 insufficient_funds 代码的已取消状态。您的脚本应捕获此错误并触发内部余额警报。

代理商店 API 是否支持自动续订?

是的。您只需在 JSON 中为支持的产品将 auto_renew 参数设置为 true。

如果批量订单中的某一项失败会怎样?

端点完全独立地处理数组中的每个位置。有效项目将成功付款。

如何按国家筛选代理?

在您的 GET 请求中添加 country 参数。使用标准 ISO 3166-1 alpha-2 格式。

API 是否支持 HTTP 和 SOCKS5 筛选?

是的。传递 connection_port_http 或 connection_port_socks5 布尔参数以缩小搜索结果范围。

如何处理大型目录响应?

使用 page 和 page_size 分页参数控制数据输出。

在哪里可以找到完整的参数列表?

阅读 CyberYozh API 官方文档以获取完整的参数规范、限制和高级路由逻辑。