跳转至

替换IP白名单

最新更新时间:2021.11.2

本接口主要用于设置代理的IP白名单授权。 如果您需要使用IP白名单来使用代理,则可以使用本接口快速设置。


1. 接口说明

2. 参数说明

参数名 变量 变量类型 是否必填 参数说明
业务编号 trade_no string 由巨量系统生成的业务编号,全局唯一。
示例值:1765244755300652 查看我的订单
替换的白名单IP new_ip string 需要替换的IP列表,多个IP用英文逗号分隔。
例如:8.8.8.8,9.9.9.9
被替换的白名单IP old_ip string 被替换的IP列表,多个IP用英文逗号分隔。
例如:8.8.8.8,9.9.9.9
是否重置白名单 reset string 是否重置已经存在的白名单
不带此参数代表不重置已经存在的白名单
固定值 : "1"
加密签名 sign string 根据规则加密后的sign字符串
示例值:3a6e9419fc9de3425e87b7e63bc6d444

3. 调用示例

在产品管理生成提取链接得到业务编号和API Key。

  • 业务编号:1765244755300652
  • 需要被替换的白名单IP列表:1.1.1.1,9.9.9.9
  • 替换的白名单IP列表: 99.99.99.99,8.8.8.8
  • ApiKey:3a6e9419fc9de3425e87b7e63bc6d444

调用示例

为订单设置如下两个IP为白名单:99.99.99.99,8.8.8.8

GET  http://v2.api.juliangip.com/dynamic/replaceWhiteIp?
new_ip=99.99.99.99,8.8.8.8
&old_ip=6.6.6.6
&reset=1
&trade_no=2222888023054219
&sign=4a9dc7bb1fbd36f04893abb322e59asx

Api加密规则详解

sign的计算方式请点击查看Api加密规则详解

4. 返回结果

请求成功返回示例

{
    "msg": "请求成功",
    "code": 200,
    "data": {
    "white_ip_count": 5,
    "surplus_white_ip_quantity": 3,
    "current_white_ip": [
    "99.99.99.99",
    "8.8.8.8"
    ]
    }
}

请求失败返回示例

{
  "code": 401,
  "msg": "签名验证失败,请检查签名参数和方法是否都符合签名算法要求",
  "data": []
}

错误提示

大部分错误都可以在【公共错误及解决方案】找到解决办法,具体错误原因请参照msg字段中的错误原因释义,我们尽可能为您提供详细的错误原因提示。

5、返回参数释义

参数名 变量 变量类型 是否必返 参数说明
返回码 code int 返回结果状态码
示例值:200
结果描述 msg string 针对于状态码的详细描述。
示例值:请求成功
数据内容 data object 包含接口返回的数据
可使用白名单总数 data.white_ip_count int 此业务可设置的白名单总数
当前白名单 data.current_white_ip string 此业务当前已设置的白名单IP列表
剩余可使用白名单数量 data.surplus_white_ip_quantity int 业务当前剩余可设置的白名单数量
Back to top