跳转至

获取独享代理详情

最新更新时间:2021.09.15

本接口主要用于获取独享代理信息,用户可通过此接口查询到指定独享代理的代理地址,端口,剩余时长等信息


1. 接口说明

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字段中的错误原因释义,我们尽可能为您提供详细的错误原因提示。

Back to top