应用绑定美团门店

接口说明

🚩 免费接口

🚀 用于开发者提交美团门店资料在云飞API侧创建门店，创建成功后会生成opPoiId，用于后续需要传opPoiId的接口

如果开发者不想对接此接口也可前往来客核销小程序创建门店

注意事项

该接口目的是先在云飞API侧创建门店与美团门店进行关联，获取美团门店的数据（查团购信息、验券核销）还需要扫码完成门店授权请点击查看生成美团门店授权码

opPoiId 是云飞API侧的门店ID（唯一标识），生成后永久不变。

opPoiId 与 mtShopId（美团门店ID）一一对应：若传入的 dyShopId 已存在，将直接返回原有opPoiId，不会重复创建；否则自动生成新的opPoiId

多平台门店可复用同一 opPoiId：若开发者或商家在云飞API侧已创建抖音门店并生成 opPoiId，后续创建美团门店时，可直接将该 opPoiId 传入接口，实现同一商家多平台门店共用一个门店ID

businessType：业务类型区分到店综合和到店餐饮，这里跟申请应用开户时选择的应用类型含义相同，若开发者两种类型的应用都有申请，在生成accessToken时请使用对应类型的appId

mtAccountId：门店扫码授权与此参数值相关，请严格按照文档要求提交，在授权码扫码完成时会进行校验

expiresIn：单位（秒），此参数是创建门店成功的返回参数，若值为null则表示该门店还未完成扫码授权，若返回有值说明是连锁子门店可共用一个管理员账号mtAccountId的授权

基本信息

名称	描述
HTTP URL	http://wspacebot.yunfeiwork.com/wspace-openapi/partner/app/bind/shop?access_token=ACCESS_TOKEN
HTTP Method	POST

请求参数

请求头

参数名	参数值	必填
content-type	application/json	是

Body

参数名	类型	必填	说明
name	string	是	门店名称
mtShopId	string	是	美团门店ID，在美团经营宝PC端或APP端查看点我查看文档指南
dpShopId	string	是	点评门店ID，在美团经营宝PC端或APP端查看，若没有则和美团门店ID保持一致，此字段是为了兼容早期开店的商家在经营宝里会存在两个不一样的门店ID 点我查看文档指南
mtAccountId	string	是	管理员账号点我查看文档指南
mtAccountName	string	是	商家公司名称
address	string	是	门店地址
cityName	string	是	城市名
platform	string	是	团购平台：meituan=美团
businessType	string	是	业务类型：DDZH=到店综合、DDCY=到店餐饮

请求示例

{
    "name": "xxx自习室",
    "mtShopId": "xxxxx",
    "mtAccountId": "xxxxx",
    "mtAccountName": "上海云飞网络科技工作室",
    "address": "xxxx",
    "cityName": "xxxx",
    "platform": "meituan",
    "businessType": "DDZH"
}

响应参数

Body

参数名	类型	说明
opPoiId	string	云飞API侧的门店ID 是唯一的且固定不变，如果你使用来客核销小程序，可以在小程序内查看门店ID
name	string	门店名称
address	string	地址
cityName	string	城市
expiresIn	long	门店授权有效期，门店未完成授权此字段值为空单位：秒；具体用途参考：已授权门店查询接口里的说明
expiresTime	datetime	门店授权有效期。同expiresIn字段，门店未完成授权此字段值为空；格式：yyyy-MM-dd HH:mm:ss；具体用途参考：已授权门店查询接口里的说明

响应示例

{
    "code": 200,
    "msg": "验证成功",
    "data": {
        "opPoiId": "example",
        "name": "example",
        "address": "example",
        "cityName": "example",
        "expiresIn": 2590896,
        "expiresTime": "2025-04-16 12:32:43"   
    }
}

接口说明#

注意事项#

基本信息#

请求参数#

请求头#

Body#

请求示例#

响应参数#

Body#

响应示例#

接口说明

注意事项

基本信息

请求参数

请求头

Body

请求示例

响应参数

Body

响应示例