获取独享代理详情
最新更新时间:2021.09.15¶
本接口主要用于获取独享代理信息,用户可通过此接口查询到指定独享代理的代理地址,端口,剩余时长等信息
1. 接口说明¶
- 适用对象:所有付费用户
- 请求URL:http://v2.api.juliangip.com/alone/getips
- 请求方式:POST/GET
- 请求频率:10次/秒
2. 请求参数释义¶
参数 | 变量名 | 变量类型 | 是否必填 | 参数说明 |
---|---|---|---|---|
业务编号 | trade_no | string | 是 | 由巨量系统生成的业务编号,全局唯一。 示例值: 4945823627087445 |
SOCK代理端口 | sock_port | int | 否 | 返回的数据中携带Sock代理端口 不带此参数代表不需要 固定值: 1 示例: 51656 |
地区名称 | city_name | int | 否 | 返回的数据中携带IP归属城市名称 不带此参数代表不需要 固定值: 1 示例: 河南洛阳 |
邮政编码 | city_code | int | 否 | 返回的数据中携带IP归属城市邮政编码 不带此参数代表不需要 固定值: 1 示例: 471000 |
IP可用时间动态型独有 |
ip_remain | int | 否 | 返回的动态性IP剩余可用时长 不带此参数代表不需要 固定值: 1 示例: 1 |
业务到期时间 | order_endtime | string | 否 | 返回的数据中携带业务到期时间 不带此参数代表不需要 固定值: 1 示例: 2022-09-01 18:11:37 |
加密签名 | sign | string | 是 | 由用户ID和密钥经过MD5加密后得到的签名字符串 示例: e10adc3949ba59abbe56e057f20f883e |
3. 调用示例¶
在会员中心独享代理产品管理 -> 生成提取链接
得到业务编号和API Key。
- trade_no:
4945823627087445
- result_type:
json
- sock_port:
1
- city_name:
1
- order_endtime:
1
参数释义
获取业务号为:4945823627087445的代理信息,返回信息附带Sock代理端口、城市名称、业务到期时间等信息,此业务的ApiKey:52abf1a65bba449d985f2dd5032068a1
GET http://v2.api.juliangip.com/alone/getips?
trade_no=4945823627087445&sock_port=1&city_name=1&order_endtime=1
&result_type=json&sign=2f0c805f8b4b8a4778626fde13a45095
Api加密规则详解
sign的计算方式请点击查看Api加密规则详解
4. 返回参数释义¶
参数名 | 变量 | 变量类型 | 是否必返 | 参数说明 |
---|---|---|---|---|
返回码 | code | int | 是 | 返回结果状态码 示例值:200 |
结果描述 | msg | string | 是 | 针对于状态码的详细描述。 示例值:请求成功 |
数据内容 | data | object | 是 | 包含接口返回的数据 |
代理IP地址 | data.proxy_ip | string | 是 | 独享代理IP地址 |
HTTP代理端口 | data.http_port | int | 是 | http代理端口 |
SOCK代理端口 | data.sock_port | int | 否 | sock代理端口 |
城市名称 | data.city_name | string | 否 | 代理IP归属城市名称 |
业务到期时间 | data.order_endtime | string | 否 | 业务到期时间 |
JSON返回格式示例¶
提取成功返回示例
{
"code": 200,
"msg": "请求成功",
"data": {
"proxy_ip": "42.51.5.196",
"http_port": 16152,
"sock_port": 51656,
"city_name": "河南洛阳",
"order_endtime": "2022-09-01 18:11:37"
}
}
提取失败返回示例
{
"code": 401,
"msg": "签名验证失败,请检查签名参数和方法是否都符合签名算法要求",
"data": []
}
5. 错误码与解决方案¶
错误提示
大部分错误都可以在【公共错误及解决方案】找到解决办法,具体错误原因请参照msg字段中的错误原因释义,我们尽可能为您提供详细的错误原因提示。