应用绑定美团门店

接口说明

🚩 免费接口

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

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

注意事项

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

opPoiId：表示云飞API侧的门店ID，一旦生成固定不变；opPoiId 与 mtShopId是一一对应的关系，若传入的mtShopId在云飞API侧已存在则不会生成新的opPoiId；反之，生成新的opPoiId

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字段

响应示例

{
    "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

响应示例