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个。否则可能会影响您的体验!!