城市信息

约 322 字大约 1 分钟

GET 城市信息

GET /v1.0/static/city/

请求参数

名称	类型	必选	约束	中文名	说明
countryId	string	必填	none	国家编号	国家编号

请求示例

curl -X GET "{{domain}}/v1.0/static/city/1"
-H "Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}"
-H "api_key : {{api_key}}"
-H "shared_secret : {{shared_secret}}"

返回示例

{
  "responseStatus": "SUCCESS",
  "version": "v1.0",
  "cityInfo": {
    "countryId": 1,
    "cities": [
      {
        "cityId": 1,
        "cityNameCn": "北京",
        "cityNameEn": "Beijing",
        "provinceId": 1,
        "provinceNameCn": "北京",
        "provinceNameEn": "Beijing"
      },
      {
        "cityId": 2,
        "cityNameCn": "上海",
        "cityNameEn": "Shanghai",
        "provinceId": 2,
        "provinceNameCn": "上海",
        "provinceNameEn": "Shanghai"
      },
      {
        "cityId": 3,
        "cityNameCn": "天津",
        "cityNameEn": "Tianjin",
        "provinceId": 3,
        "provinceNameCn": "天津",
        "provinceNameEn": "Tianjin"
      },
      {
        "cityId": 4,
        "cityNameCn": "重庆",
        "cityNameEn": "Chongqing",
        "provinceId": 4,
        "provinceNameCn": "重庆",
        "provinceNameEn": "Chongqing"
      },
      {
        "cityId": 5,
        "cityNameCn": "哈尔滨",
        "cityNameEn": "Harbin",
        "provinceId": 5,
        "provinceNameCn": "黑龙江",
        "provinceNameEn": "Heilongjiang"
      }
    ]
  },
  "remark": ""
}

属性	类型	必填	说明
responseStatus	string	必填	状态
version	string	必填	版本号
remark	string	非必填	备注
cityInfo	object	必填	城市信息
countryId	string	必填	国家编号
cities	List	必填	城市列表
cityId	int	必填	城市编号
cityNameEn	string	必填	城市英文名称
cityNameCn	string	必填	城市中文名称
provinceId	int	非必填	省份编号
provinceNameCn	string	非必填	省份中文名称
provinceNameEn	string	非必填	省份英文名称

状态码

编码	说明
SUCCESS	成功
NO_FIND	无数据
UNAUTHORIZED	认证校验失败
SUPPLIER_SERVER_ERROR	系统或接口异常