# 到餐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
}
上次更新: 5/18/2023, 7:29:29 PM