1. 门店
云飞API(来客核销)
  • API接口
    • 📱 商务合作
    • 💁 技术支持
    • 接入前准备
      • OpenAPI接口调用约定
      • 申请应用开户
      • 生成accessToken
      • 💰 查询应用余额
      • 查询应用余额
      • 生成accessToken
    • 团购核销
      • 接入前必看
      • 更新日志
      • 常见问题汇总【必看】
      • 常见响应码表【开发必看】
      • 门店
        • 应用绑定美团门店
        • 生成美团门店授权码【必看】
        • 抖音门店授权步骤【必看】
        • 应用绑定抖音门店
        • 已授权门店查询
        • 设置门店授权成功回调通知地址
        • 美团门店授权成功回调
        • 单一门店评论数据查询
      • 商品
        • 获取门店团购信息
      • 团购验券
        • 查券和验券
        • 按券查询待入账账单
        • 撤销验券
        • 手机号查询可用团购券
  1. 门店

应用绑定抖音门店

接口说明#

🚩 免费接口
该接口用于开发者提交抖音门店资料在云飞API侧创建门店,创建成功后会生成opPoiId,用于后续需要传opPoiId的接口
如果开发者不想对接此接口也可前往来客核销小程序创建门店

注意事项#

该接口目的是先在云飞API侧创建门店与抖音门店进行关联
opPoiId 是云飞API侧的门店ID(唯一标识),生成后永久不变。
opPoiId 与 dyShopId(抖音门店ID)一一对应:若传入的 dyShopId 已存在,将直接返回原有opPoiId,不会重复创建;否则自动生成新的opPoiId
多平台门店可复用同一 opPoiId:开发者或商家在云飞API侧已创建美团门店并生成 opPoiId,后续创建抖音门店时,可直接将该 opPoiId 传入接口,实现同一商家多平台门店共用一个门店ID

基本信息#

名称描述
HTTP URLhttp://wspacebot.yunfeiwork.com/wspace-openapi/partner/app/bind/shop?access_token=ACCESS_TOKEN
HTTP MethodPOST

请求参数#

请求头#

参数名参数值必填
content-typeapplication/json是

Body#

参数名类型必填说明
opPoiIdstring否云飞API侧门店ID
dyShopIdstring是抖音来客门店ID 点我查看如何在抖音来客里操作门店授权
dyAccountIdstring是抖音来客账户ID
platformstring是团购平台:douyin=抖音
businessTypestring是业务类型:DDZH=到店综合、DDCY=到店餐饮

请求示例#

{
    "opPoiId": null,
    "dyShopId": "xxxxx",
    "dyAccountId": "xxxxx",
    "platform": "douyin",
    "businessType": "DDZH"
}

响应参数#

Body#

参数名类型说明
opPoiIdstring云飞API侧的门店ID 是唯一的且固定不变 ,如果你使用来客核销小程序,可以在小程序内查看门店ID
namestring门店名称
addressstring地址
cityNamestring城市
expiresInlong注意:如果字段返回值为空表示该门店还没扫授权码,如果返回有值说明是连锁子门店可共用一个管理员账号的授权,单位:秒
expiresTimedatetime同expiresIn字段

响应示例#

{
    "code": 200,
    "msg": "验证成功",
    "data": {
        "opPoiId": "example",
        "name": "example",
        "address": "example",
        "cityName": "example",
        "expiresIn": 2590896,
        "expiresTime": "2025-04-16 12:32:43"   
    }
}
修改于 2026-08-13 02:06:15
上一页
抖音门店授权步骤【必看】
下一页
已授权门店查询
Built with