技术文档:对接 API、自动开通、续费与到期停用策略
logo云上家庭IP代理

技术文档中心

最后更新:2026-02-24

用于开发者和运维同学快速接入。以下为常用接口与配置范式。

接入流程

  1. 注册并完成套餐购买
  2. 支付回调触发自动开通
  3. 返回节点 URI 与二维码
  4. 控制台展示流量、在线 IP 与到期时间
  5. 续费叠加时长,到期自动停用

策略能力

  • 并发 IP:默认 2 IP,可按套餐模板调整
  • 速度限制:支持 Mbps 级别设置
  • 流量限制:支持月度/总量配额
  • 账号生命周期:创建、续费、停用自动化

示例:批量开通接口(伪代码)

POST /admin/users/batch
{
  "template": "family_shared_400",
  "count": 10,
  "settings": {
    "ip_limit": 2,
    "speed_mbps": 10,
    "traffic_gb": 300
  }
}

示例:查询用户在线 IP 与流量

GET /api/user/{uuid}/usage
{
  "online_ips": 2,
  "ip_limit": 2,
  "traffic_used_gb": 126,
  "traffic_limit_gb": 300,
  "speed_limit_mbps": 10
}

需要对接生产系统?

可按订单系统结构提供字段映射与回调签名规范。

联系技术支持