plugin.getShopMemberInfo收藏我的收藏
收藏
我的收藏基础库 3.43.0.0 开始支持本接口。
获取店铺会员的会员信息,仅支持抖音 App 和抖音极速版 App。
前置条件
- 1.参考 电商小程序接入指南 完成小程序及资质的准备;
- 2.参考 申请行业插件 完成插件的申请,注意只有小程序拥有电商类目资质才可见申请入口;
- 3.参考 使用行业插件 进行能力的调用;
行业插件在抖音 App 版本 31.8.0 及以上,小程序基础库版本 3.4x.0.0 及以上时支持。
语法
plugin.getShopMemberInfo(options);
参数说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
shopId | string | -- | 是 | 当前小程序绑定的抖音小店id | 2.52.0.0 |
success | function | -- | 否 | 接口调用成功的回调函数 | 2.52.0.0 |
fail | function | -- | 否 | 接口调用失败的回调函数 | 2.52.0.0 |
complete | function | -- | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 2.52.0.0 |
回调成功
参数 | 参数类型 | 说明 | 最低支持版本 |
memberCardInfo | object | 会员卡片信息 | 2.52.0.0 |
memberJoinInfo | object | 会员入会信息 | 2.55.0.0 |
errMsg | string | 回调信息 | 2.52.0.0 |
memberCardInfo 说明
参数 | 参数类型 | 说明 | 最低支持版本 |
userLevel | number | 当前会员等级 | 2.52.0.0 |
cardImageUrl | string | 当前会员等级卡片图片 | 2.52.0.0 |
fontColor | string | 当前会员字体颜色 | 2.52.0.0 |
levelName | string | 当前会员等级名称 | 2.52.0.0 |
pointsAmountCent | number | 当前会员积分值,单位是分,前端展示的时候除以100(正数表示加,负数表示-) | 2.52.0.0 |
pointsLabel | string | 当前会员积分标签文案 | 2.52.0.0 |
shopLogoUrl | string | 当前商家logo链接 | 2.52.0.0 |
shopMemberName | string | 商家会员体系名称(卡片名称) | 2.52.0.0 |
memberJoinInfo 为 object,参数说明:
参数 | 参数类型 | 说明 | 最低支持版本 |
referralSource | object | 会员来源(会员来自哪个B会员的裂变) | 2.55.0.0 |
referralSource 为 object,参数说明:
参数 | 参数类型 | 说明 | 最低支持版本 |
avatarUrl | string | 会员头像 | 2.55.0.0 |
nickname | string | 会员昵称 | 2.55.0.0 |
activityId | string | 参会的 activityId | 2.55.0.0 |
回调失败
参数为 Object 类型,属性如下:
参数 | 参数类型 | 说明 | 最低支持版本 |
errNo | number | 错误码 | 2.52.0.0 |
errMsg | string | 错误信息 | 2.52.0.0 |
错误码说明
errNo | errMsg | 说明 | 最低支持版本 |
10101 | Platform auth deny | 权限错误,不在白名单内; | 2.52.0.0 |
10301 | The feature is only support in Douyin and DonyinLite | 仅支持在抖音、抖音Lite实用,当前 App 不支持这个功能 | 2.52.0.0 |
20000 | xxx should be string, but got xxx | 参数类型校验错误,请检查参数类型 | 2.52.0.0 |
21500 | Invalid login status, please check login status | 获取宿主 sessionid 失败,用户未登录 | 2.52.0.0 |
21501 | Network error | 网络错误,请检查网络状况 | 2.52.0.0 |
21502 | Server error | 服务端网关错误(如 404、502等),请联系客服助手 | 2.52.0.0 |
13000 | 系统错误 | 服务内部错误,请稍后重试或是联系客服 | 2.52.0.0 |
21601 | 抖音小店 id 不合法,仅支持 0-9 的字符 | | 2.52.0.0 |
21604 | 该用户为非会员 | 当前用户不是店铺会员,无法获取会员信息 | 2.52.0.0 |
21605 | 该店铺为非会员店铺 | 当前抖音小店未开通会员体系,请到抖店开放平台配置会员体系 | 2.52.0.0 |
21607 | 抖音小店 id 与当前小程序无绑定关系 | 抖音小店 id 与当前小程序未绑定,请检查当前小程序是否绑定抖音小店 | 2.52.0.0 |
21608 | 小程序未绑定对应应用 | 当前小程序未在店铺后台授权,请到抖店开放平台进行授权 | 2.52.0.0 |
代码示例
// 代码示例 const plugin = tt.requirePlugin('tt95aee3130ae1cbe911'); Page({ onLoad() { plugin.getShopMemberInfo({ shopId: "1111116433", success(res) { // 获取用户卡面信息 console.log("调用成功", res.memberCardInfo); }, fail(res) { console.log("调用失败", res); }, }); }, });
Bug & Tip
- •Tip:使用该接口时需要用户身份信息,请确保在调用接口前,用户已经登录宿主 App。
- •Tip:目前该接口只支持抖音 App 和抖音极速版 App,所以请在抖音 App 和抖音极速版 App 中调用。