List of cities
City data, request method: http, return json format.
Interface address
Name |
Request format |
test address |
list of cities |
GET |
http://58.250.56.5:8158/api/city/queryCity.json?reqData=xxx |
System input parameters
Name |
code |
type |
samole |
description |
Customer ID |
appKey |
String |
SZ28276 |
JL provide |
time stamp |
timestamp |
String |
1516816895000 |
Unix timestamp |
digital signature |
sign |
String |
063cae11a00896187f80eecbf922364a |
Signature method: md5 (md5 (secretKey+appKey)+timestamp) md5 uses 32-bit lowercase. |
version |
version |
String |
3.0.1 |
Version information, please refer to version description |
System output parameters
Name |
code |
type |
samole |
description |
result code |
code |
Integer |
0 |
0 indicates that the request is successful; non-0 indicates that there is a business exception. |
Results description |
errorMsg |
String |
|
misdescription |
version |
version |
String |
|
3.0.1 |
Result object |
result |
String |
|
Different requests are different objects, and incorrect requests generally return empty |
Response code |
respId |
String |
|
The only code of a single response. Please provide the code for troubleshooting business problems |
input parameter
Name |
code |
type |
Whether it is mandatory |
samole |
description |
Country number |
countryId |
Integer |
no |
70007 |
none |
Province number |
stateId |
Integer |
no |
70017 |
none |
City number |
cityId |
Integer |
no |
70002 |
none |
Page |
pageIndex |
Integer |
yes |
|
1 |
Quantity per page |
pageSize |
Integer |
yes |
|
Maximum 1000 records |
sample
{"head": {"appKey": "SZ28276","timestamp": "1516816895000","sign": "063cae11a00896187f80eecbf922364a","version":"3.0.1"},"data": {"pageIndex": 0,"pageSize":100}}
Return parameters
Name |
code |
type |
sample |
description |
total cities |
count |
Integer |
46801 |
total cities |
page no |
pageIndex |
Integer |
none |
1 |
Number of pages |
pageSize |
Integer |
none |
1000 |
hotelGeoList |
hotelGeoList |
HotelGeo[] |
none |
HotelGeo See the table below for the definition |
The objects include country, province and city information.
attribute
Name |
code |
type |
sample |
description |
countrt code |
countryId |
Integer |
none |
|
country chinese name |
countryCn |
String |
none |
|
country english name |
countryEn |
String |
none |
|
Provincial code |
stateId |
Integer |
none |
|
Provincial Chinese name |
stateCn |
String |
none |
|
Provincial English name |
stateEn |
String |
none |
|
city code |
cityId |
Integer |
none |
|
city Chinese name |
cityCn |
String |
none |
|
city English name |
cityEn |
String |
none |
|
Return example
Return example
{"respId":"2a9ac395-8da1-46f8-ab07-ca4c6b80ce97","code":0,"errorMsg":"","result":{"count":46801,"pageIndex":1,"pageSize":2,"hotelGeoList":[{"countryId":70007,"countryCn":"Z-中国","countryEn":"China","stateId":70045,"stateCn":"S山西","stateEn":"Shanxi","cityId":101,"cityCn":"W五台山","cityEn":"WuTaiShan"},{"countryId":70007,"countryCn":"Z-中国","countryEn":"China","stateId":70029,"stateCn":"X新疆","stateEn":"Xinjiang","cityId":161,"cityCn":"A阿勒泰","cityEn":"Aletai"}]}}