服务说明
接入指南
白名单IP管理接口

说明

高质API代理 IP 白名单开放接口提供给专业用户使用，普通用户请谨慎使用。

接口名：IP 白名单列表

接口地址https://api-ip.abuyun.com/whitelist/list
返回格式JSON
请求方式GET
请求示例https://api-ip.abuyun.com/whitelist/list?license=L01234567890123P&time=1547395200&sign=d34df709daf992af4d0f27431cdfaf4c

请求参数说明

参数是否必填类型说明
license是string购买的访问凭证
time是整数UNIX 10位数时间戳
sign是string签名：使用 license + time + secret 拼接后再经md5计算得到的小写字符串

响应字段说明

字段说明示例
code状态码0
whitelistIP 白名单，接口错误时没有该字段
error错误信息

接口名：检查 IP 是否已在白名单列表中

接口地址https://api-ip.abuyun.com/whitelist/exists
返回格式JSON
请求方式GET
请求示例https://api-ip.abuyun.com/whitelist/exists?license=L01234567890123P&time=1547395200&sign=d34df709daf992af4d0f27431cdfaf4c&ip=192.168.0.111

请求参数说明

参数是否必填类型说明
license是string购买的访问凭证
time是整数UNIX 10位数时间戳
sign是string签名：使用 license + time + secret 拼接后再经md5计算得到的小写字符串
ip是string要检查的 IP，多个使用英文逗号分隔。

响应字段说明

字段说明示例
code状态码0
result检查结果，IP-结果键值对，结果为1时白名单已存在该 IP，接口错误时没有该字段"127.0.0.1/32": 0,
error错误信息

接口名：添加 IP 到白名单列表

接口地址https://api-ip.abuyun.com/whitelist/add
返回格式JSON
请求方式GET
请求示例https://api-ip.abuyun.com/whitelist/add?license=L01234567890123P&time=1547395200&sign=d34df709daf992af4d0f27431cdfaf4c&ip=192.168.0.111

请求参数说明

参数是否必填类型说明
license是string购买的访问凭证
time是整数UNIX 10位数时间戳
sign是string签名：使用 license + time + secret 拼接后再经md5计算得到的小写字符串
ip是string要添加的白名单 IP，多个使用英文逗号分隔

响应字段说明

字段说明示例
code状态码0
whitelistIP 白名单，接口错误时没有该字段
error错误信息

接口名：从白名单列表删除 IP

接口地址https://api-ip.abuyun.com/whitelist/del
返回格式JSON
请求方式GET
请求示例https://api-ip.abuyun.com/whitelist/del?license=L01234567890123P&time=1547395200&sign=d34df709daf992af4d0f27431cdfaf4c&ip=192.168.0.111

请求参数说明

参数是否必填类型说明
license是string购买的访问凭证
time是整数UNIX 10位数时间戳
sign是string签名：使用 license + time + secret 拼接后再经md5计算得到的小写字符串
ip是string要删除的白名单 IP，多个使用英文逗号分隔

响应字段说明

字段说明示例
code状态码0
whitelistIP 白名单，接口错误时没有该字段
error错误信息

接口名：清空 IP 白名单列表

接口地址https://api-ip.abuyun.com/whitelist/clear
返回格式JSON
请求方式GET
请求示例https://api-ip.abuyun.com/whitelist/clear?license=L01234567890123P&time=1547395200&sign=d34df709daf992af4d0f27431cdfaf4c

请求参数说明

参数是否必填类型说明
license是string购买的访问凭证
time是整数UNIX 10位数时间戳
sign是string签名：使用 license + time + secret 拼接后再经md5计算得到的小写字符串

响应字段说明

字段说明示例
code状态码0
whitelistIP 白名单，接口错误时没有该字段
error错误信息

响应状态码说明

  • 0 成功
  • 1000 认证不通过
  • 1001 当日IP获取达到上限
  • 1003 IP 暂时耗尽
  • 1004 请求参数不合法
  • 1005 访问凭证需要充值（到期）
  • 1006 账号被禁用
  • 400 不是有效的代理请求
  • 407 授权认证失败，包括：IP不在白名单、没有走接口申请IP、申请的IP超过了有效期
  • 603 代理服务器异常
  • 608 代理请求超时
  • 704 服务器响应错误
  • 802 请求失败 #1
  • 803 请求失败 #2
  • 804 请求失败 #3
  • 805 请求失败 #4
  • 806 请求失败 #5
  • 807 短时间内请求过多
  • 810 数据转发异常 #1
  • 811 数据转发异常 #2
  • 812 数据转发异常 #3
  • 820 https 代理异常
  • 830 https 盲转错误
体验服务
现在开始，体验阿布云大数据服务
计算、网络、大数据、人工智能，阿布云助您飞跃发展
立即体验