做私域直播的团队如果用了第三方系统对接小鹅通，最近该抽时间过一遍开放平台的更新日志。10月13日那批更新里，直播管理是改动最集中的一块，字段的增删、接口的开合都占了，老的对接代码不做核对，跑着跑着就可能报错。

变化最直接的是获取直播详情 2.0。这个接口移除了 img_url、alive_img_url 和 warm_up_video_cover_url 这类资源链接字段，原来直接从详情里拿封面和暖场视频地址的写法，现在拿不到了。直播状态的管理也拆开了，新增了上架直播、下架直播和删除直播几个独立接口，原来一步到位的操作要分开调。

创建直播和编辑直播接口目前存在问题，官方说明在修复中，近期将重新开放文档。正在排期的对接团队最好把这两项挪出本轮计划，等文档重新放出再动，不然开发到一半接口定义变了，返工成本更高。

用户管理这一块的变化对老系统影响更直接。注册新用户不再支持同时传 data.wx_union_id 和 data.phone，只能传其中一个。更新用户信息同样收窄，data.update_data 里的 phone 和 wx_union_id 都不再接受。原生 SDK 登录态做了同样的调整，union_id 和 phone 也不能一起传了。如果对接代码里恰好同时传了这两个参数，接口大概率直接报错，上线前把注册和登录这两个环节跑一遍，比等用户反馈快得多。

推广员管理的改动相对温和。查询推广员列表补上了 created_at 和 bind_time 两个响应字段，之前文档里缺失的这两个字段现在写清楚了。新增了 distributor_type 参数，可以区分推广员和门店员工，做分销报表的团队不用再靠猜的思路去判断身份。level 等级的说明也修正了，1 是普通，2 是高级，3 是超级，商家可以自定义等级，文档里原来那行重复的 avatar 字段也清掉了。

商品和订单的筛选能力在补齐。查询商品列表 2.0 新增 start_time 和 end_time 参数，可以按上架时间筛商品。订单列表 2.0 加了 marketing_play 营销玩法筛选，做活动复盘的系统能直接拉到指定玩法下的订单。页面统计列表也支持按创建时间区间查询了。做数据看板的对接方不用再把全量数据拉回来自己过滤，接口侧就能筛掉一大部分。

消息推送侧有两个点值得单独说。用户标签变更新增了消息推送，做客户分层的系统可以把原来定时拉标签的轮询改成事件驱动，标签一变就收到通知。Encrypt 标签解密后的数据格式新增了 xe_data 字段，订单、商品和用户信息直接放在里面，解密流程要跟着调整一遍。

训练营 Pro 更名为课程这件事容易漏掉，所有文档字段文案已经更新。老代码里按训练营命名的字段暂时还能跑，但查文档时按新名字去找会快很多，对接文档和代码里的叫法对不上，沟通成本会悄悄涨上去。

这些字段层面的变化，大多数商家在日常操作里感觉不到。管理台的开播、发券和看数据，走的还是原来的界面。但私域直播这套流程往往靠几个工具串起来，报名数据同步、回放归档和社群提醒，中间任何一环的接口字段变了，那一环就会断。商家发现数据不同步时，可以先问服务商有没有跟进 10 月这批更新，比自己在后台反复重试更快定位。

正在考虑上系统对接的商家，开通环节可以先把话说在前头。小鹅通开通走官网自助或者服务商协助都可以，开通之前让服务商确认一下所用版本对这批接口变动的适配情况，把对接范围和责任写清楚，后面扯皮会少很多。

官方渠道顺手记一下。小鹅通官网的产品页和公告能看到版本动态，接口细节在开放平台的文档中心，按模块搜直播管理就能定位到这次的变更。拿不准的问题找小鹅通客服，或者直接拨小鹅通客服电话核对，比在群里等别人截图要快。

接口调整是 SaaS 平台的常态，更新日志页面值得收藏。每次做对接排期之前，把最近三个月的变更过一遍，省下的返工时间比读日志花掉的多。

• 上一篇：直播电商有了福建标准，小鹅通开通的商家先看留存
• 下一篇：没有了