1. 门店
云飞API(来客核销)
  • API接口
    • 📱 商务合作
    • 💁 技术支持
    • 🤖AI快速接入
    • 接入前准备【必看】
      • 🤖 AI 辅助开发指南
      • OpenAPI接口调用约定
      • 申请应用开户【必看】
      • 生成accessToken
      • 💰 查询应用余额
      • 生成accessToken
    • 团购核销
      • 接入前必看
      • 🚩常见问题汇总【必看】
      • 🚩常见响应码表【开发必看】
      • 📖更新日志
      • 门店
        • 已关联门店查询
        • 设置回调通知地址
        • 🚩关联美团门店
          • 0.快速接入美团门店指引【必看】
          • 1.应用绑定美团门店
          • 1.1.设置门店授权成功回调通知地址【可选】
          • 2.生成美团门店授权码【必看】
          • 2.1.美团门店授权成功回调【可选】
          • 美团门店解除授权
          • 美团门店同步结果回调通知
          • 美团服务零售客户授权结果回调通知
          • 查询已授权美团服务零售客户
        • 🚩关联抖音门店
          • 0.快速接入抖音门店指引【必看】
          • 1.抖音门店授权步骤【必看】
          • 2.应用绑定抖音门店
        • 🚩关联快手门店
          • 1.快手门店授权步骤【必看】
          • 应用绑定快手门店
      • 商品
        • 获取门店团购信息
      • 团购核销API
        • 查券和验券
        • 撤销验券
        • 批量撤销验券
        • 手机号查询可用团购券
        • 团购退款预校验
        • 团购退款申请
        • 团购退款信息查询
        • 团购退款审核
      • 订单服务API
        • 订单券码分摊金额查询
        • 查询团购订单结算扩展明细
  1. 门店

已关联门店查询

接口说明#

🚩 免费接口
🚀 用于查询当前应用所绑定的门店,会返回该门店授权了哪些平台

注意事项#

获取 access_token 调用 点我生成accessToken

基本信息#

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

请求参数#

请求头#

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

Body#

参数名类型是否必填说明
pageint是页码,默认1
limitint是每页条数,默认10
opPoiIdstring否云飞API侧的门店ID,不传查当前应用绑定的所有门店
opBizCodestring否美团服务零售客户代码,用于查询通过自动同步关联的门店

请求示例#

{
    "page": 1,
    "limit": 10,
    "opPoiId": null
}

响应参数#

Body#

参数名类型说明
opPoiIdstring云飞API侧的门店ID
namestring门店名称
addressstring地址
cityNamestring城市
expiresInlong门店授权过期时间(单位:秒)
expiresTimedatetime门店授权过期时间(格式:yyyy-MM-dd HH:mm:ss)
authorizePlatformsarrays当前门店已完成授权的平台
authorizePlatforms 字段结构
属性类型说明
platformstring已授权平台,meituan=美团(美团、大众点评共用),douyin=抖音(即抖音来客)
statusint授权状态 0=未授权 1=已授权 2=授权失败 3=授权已过期
autoRenewboolean新版授权新增加的字段,用于表示美团门店的授权是否会自动续期;值为 true 表示云飞API侧会为门店自动续期授权( expiresIn、expiresTime 这两字段值为了兼容老版本默认会返回 30 天,美团门店使用新版授权成功后云飞API侧会在到期前进行自动续期授权,对接方无在需额外关注),如果返回值为 false 表示无法自动续期
expiresInlong门店授权过期时间(单位:秒), 抖音授权自动续期不返回,老版本美团门店授权会返回
expiresTimedatetime门店授权过期时间(格式:yyyy-MM-dd HH:mm:ss) 抖音授权自动续期不返回,老版本美团门店授权会返回
bindStatusint表示平台门店与云飞侧门店绑定关系, 0=未绑定 1=已绑定

响应示例#

{
    "code": 200,
    "msg": "成功",
    "data": [
        {
            "opPoiId": "example",
            "name": "example",
            "address": "example",
            "cityName": "example",
            "expiresIn": 2590896,
            "expiresTime": "2025-04-16 12:32:43",
            "authorizePlatforms": [
                {
                    "platform": "meituan",
                    "status": 1,
                    "expiresIn": 2161135,
                    "expiresTime": "2025-07-26 16:42:58"
                },
                {
                    "platform": "douyin",
                    "status": 1
                }
            ]
        }
    ]
}
修改于 2026-11-02 11:57:31
上一页
📖更新日志
下一页
设置回调通知地址
Built with