# 到餐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
}