plugin.getShopMemberInfo
收藏
我的收藏

基础库 3.43.0.0 开始支持本接口。
获取店铺会员的会员信息,仅支持抖音 App 和抖音极速版 App。

前置条件

在使用电商插件中的组件和 API 前,需要对行业插件有一个基本了解,可以参考文档:行业插件介绍,然后按照以下步骤及顺序使用电商插件中的能力:
    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 中调用。