Check

最新更新时间：2021.09.15¶

本接口主要用于在线校验代理有效性，方便您业务的正常开展。如果您在使用前不能确定某个代理IP是否有效时，可以调用此接口检测一下。

1. 接口说明¶

适用对象：所有付费用户
请求URL：http://v2.api.juliangip.com/dynamic/check
请求方式：POST/GET
请求频率：10次/秒

特别提示

每次提取到的IP都是经过系统严格验证的，但各产品的代理时效不同，难免会有一些代理提取时间过长未使用而过期时效的问题，并不代表IP质量问题。请理解！😊😊😊

2. 请求参数释义¶

参数名	变量	变量类型	是否必填	参数说明
业务编号	trade_no	string	是	由巨量系统生成的业务编号，全局唯一。示例值：1765244755300652
代理列表	proxy	string	是	需要验证的代理列表，格式为：`ip:port`。单个示例值:`61.161.28.187:40919` 多个示例值：`61.161.28.187:40919,182.34.26.141:37604`
加密签名	sign	string	是	根据规则加密后的sign字符串示例值：`7bba91a5778dfde6c17baa02ef79a933`

3. 调用示例¶

参数演示

业务编号：1483587531995538
代理列表：61.161.28.187:40919,182.34.26.141:37604
key：b433718d3e374fea8cd5a368ff8a3f4f

请求演示

GET http://v2.api.juliangip.com/dynamic/check?
trade_no=1483587531995538&
proxy=61.161.28.187:40919,182.34.26.141:37604&
sign=7bba91a5778dfde6c17baa02ef79a933

Api加密规则详解

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

4. 返回结果示例¶

请求成功返回示例¶

{
  "code": 200,
  "msg": "请求成功",
  "data": {
    "61.161.28.187:40919": true,
    "182.34.26.141:37604": false
  }
}

请求失败返回示例¶

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

错误提示

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

5. 返回结果释义¶

参数名	变量	变量类型	是否必返	参数说明
返回码	code	int	是	返回结果状态码示例值：200
结果描述	msg	string	是	针对于状态码的详细描述。示例值：请求成功
数据内容	data	object	是	字典格式，key: 代理ip（格式ip:port），value: 是否有效（boolean型）示例：{"61.161.28.187:40919": true, "182.34.26.141:37604": false}

友情提示

因代理需实时校验，一次提交太多的话，比较耗时，建议您单次提交不要超过10个。否则可能会影响您的体验！！