跳转至

获取可用城市

最新更新时间:2021.12.14

用户可通过此接口获取指定省份下可用代理城市信息


1. 接口说明

2. 参数说明

参数名 变量 变量类型 是否必填 参数说明
用户ID user_id int 由巨量系统分配的用户ID,全局唯一
示例:1000000
省份名称 province string 需要查询的对应省份名称
(不传参默认返回全部可用城市):
示例: "山东,河北,山西" (多个省份以英文逗号进行分隔)
加密签名 sign string 由用户ID和密钥经过MD5加密后得到的签名字符串
示例:e10adc3949ba59abbe56e057f20f883e

3. 调用示例

在会员中心账户信息 -> Api信息得到用户ID用户Key

  • 用户ID:1000000
  • ApiKey:99064631962e4e838dac1143092f6112

下面调用示例使用的是虚假的用户ID和Key来生成的样例,实际生产环境中需要您使用自己的信息进行数字签名验证。

GET http://v2.api.juliangip.com/users/getCity?province=河北,山东,山西&user_id=1000000&sign=551cddf99e561d91999da7811776e155

Api加密规则详解

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

4. 返回结果示例

请求成功返回示例

{
    "msg": "成功",
    "code": 200,
    "data": {
        "info": [
            {
                "province": "河北",
                "city": "保定"
            },
            {
                "province": "河北",
                "city": "石家庄"
            },
            {
                "province": "河北",
                "city": "邢台"
            }
        ]
    }
}

请求失败返回示例

{
  "code": 400,
  "msg": "sign校验失败,请重新计算",
  "data": []
}

错误提示

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

5、返回参数释义

参数名 变量 变量类型 是否必返 参数说明
返回码 code int 返回结果状态码
示例值:200
结果描述 msg string 针对于状态码的详细描述。
数据内容 data object 接口返回的数据
订单号列表 info List 所属省份下的城市信息列表
省份名称 province String 代理IP所属省份
城市名称 city String 代理IP所属城市
Back to top