背景说明:

兔展内容中台支持和外部积分系统打通,支持调用第三方积分(增加/减少)。

功能说明:

准备工作

1、申请自建应用,选择【积分】,勾选需要的权限功能,如果只要积分变动,选择前两项即可;

2、填写接收积分变动的回调地址(需要客户提供)

编辑器配置:

在编辑器中的玩法配置中,【初始积分】选择【调用平台积分】,则外部积分即可生效。

接口示例——积分增加:

接口地址 自建应用配置

请求方式 POST

consumes ["application/json"]

produces ["application/json"]

应用权限 积分 -> 外部积分-增加

注意事项 可配置接口安全加密,当勾选数据安全传输加密算法时,会校验是否开通数据安全功能,并配置了加密方式。此时接口入参只有密文,参数名:encryptStr,如果是开放平台企业,还有租户信息。

请求参数


参数名称参数说明请求类型是否必须数据类型schema备注
encryptStr密文bodytruestring

uid开放平台租户uidbodyfalsestring
开放平台租户才有该字段
companyId开放平台租户companyIdbodyfalsestring
开放平台租户才有该字段

密文解析后的参数


参数名称参数说明请求类型是否必须数据类型schema备注
pointRecordId积分记录idbodytruelong
220531新增
openids身份识别标识集合bodyfalsearray身份识别标识
phoneList手机号码列表bodyfalsearray手机号码
audienceUserId客户档案IDbodyfalselong

point积分变动值bodytrueint

remark备注bodytruestring

eventType行为类型bodyfalsestring

avatar用户头像bodyfalsestring

nickName用户昵称bodyfalsestring

contentId内容ID(作品ID)bodyfalsestring

contentName内容名称(作品名称)bodyfalsestring

ext扩展信息bodyfalsestring
json字符串

身份识别标识

参数名称参数说明请求类型是否必须数据类型schema
openid
bodyfalsestring
unionid
bodyfalsestring
fromTo应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群)bodyfalsestring
appid应用IDbodyfalsestring
jcappid系统集成应用实例IDbodyfalselong
identityId身份识别类型IDbodyfalsestring
identityType身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid)bodyfalsestring

具体接口地址:积分

接口目录: