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

应用绑定抖音门店

接口说明#

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

注意事项#

该接口目的是先在云飞API侧创建门店与抖音门店进行关联
opPoiId:表示云飞API侧的门店ID,一旦生成固定不变;opPoiId 与 dyShopId是一一对应的关系,若传入的dyShopId在云飞API侧已存在则不会生成新的opPoiId;反之,生成新的opPoiId;如果一个商家同时有美团门店和抖音门店,开发者若是先创建了美团门店后创建抖音门店,可以共用一个opPoiId,开发者将opPoiId作为参数回传给接口即可

基本信息#

名称描述
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-06-16 14:47:54
上一页
抖音门店授权步骤
下一页
已授权门店查询
Built with