# 到餐api-商家列表接口
# 1.查询商家列表
# 接口说明
| 名称 | 描述 |
|---|---|
| 功能 | 到餐商家列表 |
| HTTP方法 | POST |
| 请求方 | 第三方渠道 |
| 响应方 | 美团企业版平台 |
| url | /$API_HOST/daocan/v1/poi/list |
| method | daocan.poilist |
# 公共参数
# 业务请求参数
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| cityCode | String | 是 | "110114" | 标准城市编码 |
| keyword | String | 是 | "火锅" | 查询关键字 |
| serviceTypeKey | List | 否 | ["010110","010120"] | 服务类型包含:买单、团购、扫码付、付款码、订座,多个值表示:包含命中任意一项服务就会返回, |
| AvgPriceKey | Object | 否 | 见AvgPriceKey定义 | 人均价 |
| sortTypeKey | Integer | 否 | 1 | 排序规则,单选,详细见枚举定义 |
| longitude | String | 否 | "116.42010122997081" | 经度,参数sortTypeKey=2时,必传 |
| latitude | String | 否 | "40.061998675107965" | 纬度,参数sortTypeKey=2时,必传 |
| pageNum | Integer | 是 | 1 | 分页参数,当前页,1开始 |
# AvgPriceKey
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| minPrice | Integer | 否 | 20 | 最低价,应满足 > 0 且 < 最高价 |
| maxPrice | Integer | 否 | 200 | 最高价,应满足 > 0 且 > 最低价 |
# serviceTypeKey
| key | value |
|---|---|
| "010110" | 团购 |
| "010120" | 买单 |
| "010130" | 扫一扫 |
| "010140" | 付款码 |
| "010160" | 预定 |
# sortTypeKey
| key | value |
|---|---|
| 1 | 智能排序 |
| 2 | 距离优先 |
| 3 | 好评优先 |
| 4 | 低价优先 |
| 5 | 高价优先 |
# 业务响应
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| poiList | List | 否 | 见Poi定义 | 商家列表 |
| pageNum | Integer | 否 | "1" | 当前页 |
| hasNext | Boolean | 否 | false | 是否有下一页 |
# Poi
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| poiId | String | 否 | "122211" | 美团商家id |
| poiName | String | 否 | "**火锅" | 门店名称 |
| categoryName | String | 否 | "四川美食" | 品类描述 |
| poiImgUrl | String | 否 | "www.***.com" | 门店图片 |
| shoppower | String | 否 | "45" | 星级 (10分制),shoppower/10 = 评分 |
| avgPrice | String | 否 | "45" | 人均消费价格 |
| serviceTypeList | String | 否 | ["010110","010120"] | 当前商家支持的服务类型 |
# 示例
请求参数
{
"token":"B3DKRWZEMOLE-TK",
"version":"1.0",
"content":"3-BphEu-5BXWOmDaI9B3O_JjxtpMW0z-Q9Uh6w29n8mRPmcwrtfLVeT4cJ7q8RcXcOOy0zJbGuGVUoHtVzEXzespz5AZB7mRNULm19SwHgWxkl3wc5Sa1ec4OvgfSNuwuEFgCCM1Y3S8NVRwC2IS55pu9l56rorJrpc8DB5R2s7WQXFMtPLeytGX5849nO1AaHv-7Lfj80xxnY3dqYj83Srht_liSdkVPgPEgU38I_Y"
}
业务请求参数-content结构体
{
"cityCode": "110114",
"keyword": "火锅",
"serviceTypeKey": [
"010120",
"010110"
],
"avgPriceKey": {
"minPrice": 20,
"maxPrice": 200
},
"sortTypeKey": 5,
"longitude": "116.42010122997081",
"latitude": "40.061998675107965",
"pageNum": 1,
"entId": 100633,
"method": "daocan.poilist",
"ts": 1660288648
}
业务响应
{
"data": {
"poiList": [
{
"poiId": "1646244",
"poiName": "丽江庭院之爱在路上西单店",
"categoryName": "云南火锅",
"poiImgUrl": "https://qcloud.dpfile.com/pc/BBDGC1S39IVTJHKMYH4ix2xQPM_bpY2zKTdRA1_t3JLR7Vgtxuf-v_GOtsJd4pCADxEm9rfL2yd5nyBLcd65sg.jpg",
"shoppower": "45",
"avgPrice": "159",
"serviceTypeList": [
"010120",
"010140"
],
"buisnessStatus": null,
"buisnessTime": null,
"address": null,
"phoneNo": null
},
{
"poiId": "533615",
"poiName": "羊大爷涮肉",
"categoryName": "老北京火锅",
"poiImgUrl": "https://qcloud.dpfile.com/pc/qiqvTv1SnmZC-9WEvXFo5MPoFLRQaGEyvKOB0Odt801KTT7DfA2TTIP91vsaqA3xDxEm9rfL2yd5nyBLcd65sg.jpg",
"shoppower": "40",
"avgPrice": "105",
"serviceTypeList": [
"010120",
"010140"
],
"buisnessStatus": null,
"buisnessTime": null,
"address": null,
"phoneNo": null
}
],
"pageNum": 1,
"hasNext": false
},
"status": 0,
"message": null
}
# 2.查询商家详情
# 接口说明
| 名称 | 描述 |
|---|---|
| 功能 | 到餐商家详情 |
| HTTP方法 | POST |
| 请求方 | 第三方渠道 |
| 响应方 | 美团企业版平台 |
| url | /$API_HOST/daocan/v1/poi/detail |
| method | daocan.poidetail |
# 公共参数
# 业务请求参数
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| poiId | String | 是 | "123123131" | 美团poiId |
# 业务响应
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| poiId | String | 否 | "122211" | 美团商家id |
| poiName | String | 否 | "**火锅" | 门店名称 |
| shoppower | String | 否 | "45" | 星级 (10分制),shoppower/10 = 评分 |
| avgPrice | String | 否 | "200" | 人均消费价格 |
| businessStatus | String | 否 | "5" | 营业状态 |
| businessHours | String | 否 | "周一至周日\n10:00-22:00" | 营业时间 |
| address | String | 否 | "首体南路9号主语国际7号楼2楼" | 地址 |
| phoneNo | String | 否 | "57122556" | 电话 |
| serviceTypeList | String | 否 | ["010110","010120"] | 当前商家支持的服务类型 |
# serviceType
| key | value |
|---|---|
| "010110" | 团购 |
| "010120" | 买单 |
| "010130" | 扫一扫 |
| "010140" | 付款码 |
| "010160" | 预定 |
# businessStatus
| key | value |
|---|---|
| "0" | 手机收录商户 |
| "1" | 已关 |
| "2" | 暂停歇业 |
| "4" | 尚未营业 |
| "5" | 正常 |
| "15" | 侵权商户 |
# 示例
请求参数
{
"token":"B3DKRWZEMOLE-TK",
"version":"1.0",
"content":"3-BphEu-5BXWOmDaI9B3O_JjxtpMW0z-Q9Uh6w29n8mRPmcwrtfLVeT4cJ7q8RcXcOOy0zJbGuGVUoHtVzEXzespz5AZB7mRNULm19SwHgWxkl3wc5Sa1ec4OvgfSNuwuEFgCCM1Y3S8NVRwC2IS55pu9l56rorJrpc8DB5R2s7WQXFMtPLeytGX5849nO1AaHv-7Lfj80xxnY3dqYj83Srht_liSdkVPgPEgU38I_Y"
}
业务请求参数-content结构体
{
"poiId": "2431390",
"entId": 100633,
"method": "daocan.poidetail",
"ts": 1660544059
}
业务响应
{
"code": 0,
"data": {
"poi": {
"poiId": "2431390",
"poiName": "滇釜火锅·能喝汤的火锅车公庄店",
"categoryName": null,
"poiImgUrl": null,
"shoppower": "45",
"avgPrice": "134",
"serviceTypeList": [
"010120"
],
"buisnessStatus": "5",
"buisnessTime": "周一至周日\n10:00-22:00",
"address": "首体南路9号主语国际7号楼2楼",
"phoneNo": "57122556"
}
},
"message": null
}