获取可用城市

最新更新时间：2022.10.11¶

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

1. 接口说明¶

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

2. 参数说明¶

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

3. 调用示例¶

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

用户ID：1000000
key：99064631962e4e838dac1143092f6112

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

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

Api加密规则详解

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

4. 返回结果示例¶

请求成功返回示例¶

{
    "code": 200,
    "msg": "请求成功",
    "data": [
        {
            "province": "河北",
            "city": [
                "邯郸",
                "石家庄",
            ]
        },
        {
            "province": "山东",
            "city": [
                "德州",
                "烟台"
            ]
        }
    ]
}

请求失败返回示例¶

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

错误提示

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

5、返回参数释义¶

参数名	变量	变量类型	是否必返	参数说明
返回码	code	int	是	返回结果状态码示例值：200
结果描述	msg	string	是	针对于状态码的详细描述。
数据内容	data	Array	是	接口返回的数据
省份名称	province	String	是	代理IP所属省份
城市名称	city	String	是	代理IP所属城市