更换IP资源

发布时间:2022-06-01 00:00

1.接口描述

接口地址:https://proxy.yunkv.com/replace

本接口用于替换代理IP。
该接口单个Key的请求频率限制为:(通道数*5)+10 次/分钟;
方法:HTTP、GET,需要注意不能混合使用;
编码:参数和返回内容均采用utf-8编码。

2.输入参数说明

参数名 是否必选 类型 描述
Key String 更换IP的Key值
KeepAlive Interger 存活周期;默认动态独享24小时,动态共享默认购买的套餐存活周期时长
AreaId Interger 区域ID;默认随机
ISP Interger 运营商ID;默认随机
Num Intger 申请数量,默认为全部
Detail Interger 详情0(关闭) 1(开启) ,默认为 0
Distinct Interger 去重0(关闭) 1(开启),默认为0
DataFormat String 数据格式,本接口取值:json、html、text ,默认为 json格式
DataSeparator String 分隔符,自定义

3.返回值

接口可返回文本格式、json格式、xml格式,字段说明如下:

参数名 类型 描述
Code Integer 结果编码:0(成功)-1(失败)
TaskID Integer 任务ID
Num Intger 申请数量
Data Array 代理IP数据信息,包含节点IP、端口、失效日期
Msg String 区域ID

4 示例

请求接口示例:

  1. https://proxy.yunkv.com/replace?Key=请改成您的Key

返回示例:

  1. {
  2. "Code ":0,
  3. "TaskID ":"91107E16D28AC5A",
  4. "Num " : "1"
  5. "Data": [
  6. "IP ": "127.0.0.1",
  7. "port ": "49168",
  8. "deadline ": "2018-05-11 02:56:02",
  9. "host ": "127.0.0.1:49168",
  10. ]
  11. }

5.错误码

错误码 描述
-1 未知错误
-10 Authkey对应的业务无此权限
-11 请求过于频繁
-100 计划不存在或已过期
-101 请求数量超过计划通道数
-103 资源不足
本文导读

客户热线:1830934534