查询子一级城市(全量同步)
- 接口: /reference-data/city/by-parent-code
- Method-Type:GET
- 调用方:第三方
- 接口说明:第三方根据这个接口, 建立与每刻城市的映射。
请求参数
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
parentCode | String | N | 每刻城市唯一编码 |
[info] 说明:
[1] 当 parentCode 为 null 时,返回每刻城市库中的所有国家 ;
[2] 当 parentCode 不为空时,返回该 code 下的所有子一级城市(不包含子 N 级城市),详情看如下示例。示例:
parentCode 传 CHN001(中国),将返回子一级城市:CT110000(北京),CT310000(上海)P330000(浙江)等……
parentCode 传 CT330100(杭州),同样将返回子一级城市:CF330102(上城),CF330103(下城),CF330106(西湖)等……
响应结构
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
code | String | Y | 请求是否成功 (ACK / NACK) |
message | String | N | 调用详情(如果 code 为 NACK, 该值为必填,表示为失败信息) |
data | List<City> | Y | 城市列表 |
City
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
code | String | Y | 城市在每刻中的唯一编码 |
name | String | N | 城市名称 |
nameEn | String | N | 城市英文名 |
adminDivCode | String | N | 行政区划编码(国内城市) |
adminDivName | String | N | 行政区划名(国内城市) |
parentCode | String | N | 父级城市唯一编码 |