文档

测试

1.获取已开通城市列表

websocket测试

POST

api_method:u-city-list

调用注意事项

1.货拉拉城市信息是固定的么？答:货拉拉侧城市信息不定时更新(由货拉拉运营配置)，建议采用定时任务从此接口获取货拉拉最新城市列表 2.货拉拉建议开发者定时任务设置为多久一次？答:货拉拉将在接口返回值中返回“建议下次更新获取时间expire”。开发者可按照此值,在此时间之后进行重新调用获取。 3.是否还有其他情况需要立刻刷新获取城市列表？答:当计价接口或下单接口返回某个特殊的错误码ret=30011,代表城市信息发生了变更,也需调用此接口重新获取城市列表信息。

编码

++数据编码:++ Accept:application/json Content-type: application/json ++字符编码:++ utf-8

前端UI界面示例

![image.png](https://cos.easydoc.net/48578360/files/k93pne8o)

系统级请求参数

参数名

类型

描述

必填

api_method

string

接口方法名。请传"u-city-list"

必填

api_version

string

接口版本号。请传固定值“1.0”

必填

app_key

string

开发者应用唯一app_key

必填

nonce_str

string

随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复

必填

timestamp

number

unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时

必填

signature

string

签名值

必填

响应参数

参数名

类型

描述

必填

ret

int

示例：0

必填

msg

string

示例：

必填

data

object

数据字典

必填

city_list

array

城市列表信息

必填

city_id

int

城市ID(货拉拉自遍)

必填

adcode

string

国家行政区划城市代码

必填

name

string

城市名称(中文), 示例：⼴州

必填

name_en

string

城市名称(英文), 示例：guangzhou

必填

is_hot

int

是否属于热门城市,0否 1是

必填

lat_lon

object

城市经纬度数据字典(gcj02坐标系)

必填

lat

double

纬度，示例：23.129061

必填

lon

double

经度，示例：113.26435

必填

expire

long

城市信息缓存刷新时间(unix时间戳,单位秒)，示例：1585204992

必填

请求json示例：

```json { "api_method":"u-city-list", "api_version":"1.0", "app_key":"***************************", "nonce_str":"12345", "timestamp":1574824720, "signature":"*********************", "api_data":"{ }" } ```

返回json示例:

```json { "ret":0, "msg":"", "data":{ "city_list":[ { "city_id":1001, "name":"⼴州", "name_en":"guangzhou", "is_hot":1, "lat_lon":{ "lat":23.129061, "lon":113.26435 } } ], "expire":1585204992 } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功|

上一篇错误码说明

nextDoc 2.获取城市下可选车型及增值服务