门店可达范围查询
基本信息
| 接口名称 | |
|---|---|
| 请求方式 | Post application/x-www-form-urlencoded |
| 功能描述 | 商家调用该接口查询门店可达范围 |
| 编码 | UTF-8 |
入参
| 项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|---|
| 对接码 | logistic_provider_id | String | 是 | 双方约定 | |
| 签名 | data_digest | String | 是 | Base64(Md5(logistics_interface+双方约定的secretKey)) ,0.2 签名方法 | x-www-form-urlencoded格式可能会出现加号变空格的情况，发请求之前可以对签名进行urlencode |
| 业务报文 | logistics_interface | String | 是 | JSON |
logistics_interface内容
| 项目 | 名称 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|---|
| 门店id/编码 | storeId | String | 否 | 门店id和唯一标识不能同时为空 | 10002 |
| 门店唯一标识 | masterCode | String | 否 | 门店id和唯一标识不能同时为空 | customer_warehouse_1234 |
出参
| 项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|---|
| 成功标识 | success | Boolean | 是 | ||
| 错误码 | errorCode | String | 否 | ||
| 错误说明 | errorMsg | String | 否 | ||
| 门店范围信息 | storeRangeInfo | StoreRangeInfo | 否 |
StoreRangeInfo内容
| 项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|---|
| 门店范围 | deliveryRange | String | 是 | wkt格式，可能返回POLYGON(单个围栏)、MULTIPOLYGON(多个围栏) | |
| 揽收站位置 | siteCenterPoint | String | 是 |
示例报文
请求： 仅供参考，实际测试账号需联系菜鸟速递开发提供
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardQueryStoreRange/ediStandardQueryStoreRange/api
logistic_provider_id: edi_test_json
logistics_interface: {"masterCode":"customer_warehouse_7503"}
data_digest: GXT7l3l8yHGaUaaguxf5Mw==
返回：
{"success":true,"storeRangeInfo":{"deliveryRange":"POLYGON ((120.07 30.2947, 120.0834 30.2936, 120.0851 30.287, 120.0867 30.2809, 120.0619 30.2805, 120.0622 30.2871, 120.0634 30.2956, 120.07 30.2947))","siteCenterPoint":"POINT(116.407242 39.916108)"}}