文档

测试

1.获取已开通城市列表

websocket测试

POST

api_method:u-city-list

接口描述

可获取货拉拉C端业务(货运)所有开通的城市列表信息

服务入口

测试环境:https://openapi-stg.huolala.cn/v1 正式环境:https://openapi.huolala.cn/v1

调用注意事项

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

接口方法。

必填

api_version

string

接口版本号，固定值:1.0

必填

app_key

string

应用唯一app_key

必填

access_token

string

货拉拉账户授权访问令牌

必填

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，示例：1001

必填

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 { "app_key":"***************************", "nonce_str":"12345", "timestamp":1574824720, "signature":"*********************" } ```

返回json示例:

```json { "ret":0, "msg":"", "data":{ "city_list":[ //城市信息数组 { "city_id":1001, //城市id "name":"⼴州", //城市名称(中文) "name_en":"guangzhou", //城市英文 "is_hot":1, //是否属于热门城市 "lat_lon":{ "lat":23.129061, //城市默认经度 "lon":113.26435 //城市默认纬度 } } ], "expire":1585204992 //建议城市信息缓存过期时间 } } ```

返回状态码说明

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

上一篇签名算法

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