开放平台
查询自提点列表
更新时间：2026-08-18 22:21:34
-简要描述
查询自提点列表 （方法名称：common.pudo.detail.get ）
-公共参数
请求地址
| 环境 | HTTP请求地址 |
|---|---|
| 正式环境 | https://open.yw56.com.cn/api/order |
| 测试环境 | https://open-fat.yw56.com.cn/api/order |
账号信息
| 环境 | 账号 | 秘钥 apitoken |
|---|---|---|
| 正式环境 | 贵司在我司客户号； | 登录我司客户中心系统-账号管理-制单账号管理信息下查看秘钥； |
| 测试环境 | 100000 | D6140AA383FD8515B09028C586493DDB |
公共请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| user_id | String | 是 | 客户号 |
| format | String | 是 | 报文格式 默认为json格式，可选值：json |
| method | String | 是 | api名称； |
| timestamp | Long | 是 | 时间戳(毫秒级) 有效期为5分钟 |
| version | String | 是 | api版本号 可选 V1.0 |
| sign | String | 是 | 签名(根据动态规则生成) |
| data | String | 是 | 报文内容(body请求参数,放在请求体中，使用json格式) |
1.请求方式 所有接口使用 POST 方式请求，没有特殊说明 所有字符编码为utf-8； Content-Type: application/json；
2.公共请求参数放在url后面,使用&连接
3.签名规则
第一步：按字典序排列将参数拼接。具体顺序为 user_id+data+format+method+timestamp+version
第二步：将apiToken拼接到第一步的字符串的头部和尾部 apitoken+user_id+data+format+method+timestamp+version+apitoken
第三步：将第二步的结果进行md5加密； MD5(apitoken+user_id+data+format+method+timestamp+version+apitoken)
生成签名示例：
D6140AA383FD8515B09028C586493DDB100000{}jsoncommon.country.getlist1655798809414V1.0D6140AA383FD8515B09028C586493DDB
注：a.data 参数为body请求参数为json格式，并且使用压缩格式 b.MD5加密方式为32位小写；
加密后结果：bc5f1792e30936c72fa2a35efead8d73
4.请求URL示例
https://open-fat.yw56.com.cn/api/order?user_id=100000&method=common.country.getlist&format=json×tamp=1655798809414&sign=bc5f1792e30936c72fa2a35efead8d73&version=V1.0
注：user_id,method,format,version,timestamp要和生成签名时使用的参数一致。sign为生成参数签名步骤生成的md5加密后得到的
-请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| channelld | String | 是 | 产品编号 |
| country | String | 是 | 国家二字码 |
| weight | Double | 是 | 重量 kg |
| city | String | 是 | 城市 |
| address | String | 是 | 地址 |
| postCode | String | 是 | 邮编 |
| state | String | 否 | 州 |
| poinNumber | Integer | 否 | 搜索数量 默认20 |
| searchRadius | Double | 否 | 搜索半径 默认3km |
| longitude | String | 否 | 经度 |
| latitude | String | 否 | 维度 |
-响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功 true:成功 false:失败 |
| code | String | 消息编码 0:成功 >0:失败 <0:系统异常 |
| message | String | 消息内容 |
| data | Array | 实体信息 |
| country | String | 国家二字码 |
| pointId | String | 供应商自提站点编码 |
| location | String | 供应商自提站点名称 |
| type | String | 自提点类型 shop/locker/station/convenience_store |
| address | String | 地址 |
| street | String | 街道 |
| postCode | String | 邮编 |
| city | String | 城市 |
| state | String | 州 |
| distance | Double | 距离 单位km |
| longitude | String | 经度 |
| latitude | String | 维度 |
| weight | String | 重量 |
| weightUnit | String | 重量单位 kg |
| openingHours | Object | 营业时间 |
| week_day | int | 周几，用数字标识,1-7 代表周一到周日； |
| period | Object | 营业周期 |
| start_time | String | 开门时间 |
| end_time | String | 关门时间 |
-请求参数示例
{
"channelld": "1760",
"country": "PL",
"weight": 0.23,
"city": "Gdańsk",
"address": "Ludwiga Beethovena 183",
"postCode": "80-171",
"state": "",
"poinNumber": 10,
"searchRadius": 3,
"longitude": null,
"latitude": null
}
-返回示例
{
"success": true,
"code": "0",
"message": "操作成功",
"data": [{
"country": "PL",
"pointId": "GDA212M",
"location": "Przy budynku usługowym",
"type": "locker",
"address": "Morenowa 2B",
"street": "Morenowa",
"postCode": "80-172",
"city": "Gdańsk",
"state": "pomorskie",
"distance": 0.228,
"longitude": "18.59401",
"latitude": "54.35637",
"weight": "25.0",
"weightUnit": "kg",
"openingHours": [{
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 1
}, {
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 2
}, {
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 3
}, {
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 4
}, {
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 5
}, {
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 6
}, {
"period": [{
"start_time": "00:00",
"end_time": "23:59"
}],
"week_day": 7
}]
},
{
"country": "PL",
"pointId": "POP-GDA13",
"location": "SZOKOLADA LEGO",
"type": "shop",
"address": "Gojawiczyńskiej 2A",
"street": "Gojawiczyńskiej",
"postCode": "80-286",
"city": "Gdańsk",
"state": "pomorskie",
"distance": 0.666,
"longitude": "18.58994",
"latitude": "54.35952",
"weight": "25.0",
"weightUnit": "kg",
"openingHours": [{
"period": [{
"start_time": "08:00",
"end_time": "18:00"
}],
"week_day": 1
}, {
"period": [{
"start_time": "08:00",
"end_time": "18:00"
}],
"week_day": 2
}, {
"period": [{
"start_time": "08:00",
"end_time": "18:00"
}],
"week_day": 3
}, {
"period": [{
"start_time": "08:00",
"end_time": "18:00"
}],
"week_day": 4
}, {
"period": [{
"start_time": "08:00",
"end_time": "18:00"
}],
"week_day": 5
}, {
"period": [{
"start_time": "08:00",
"end_time": "14:00"
}],
"week_day": 6
}, {
"period": [],
"week_day": 7
}]
}
]
}
