积分、权益体系集成


  1. 支持互动与自有系统积分、权益体系打通。
  2. 实现互动界面部分个性化文案展示。

对接步聚

  1. 根据需要开发调用数据API程序,即可获取对应数据;

  2. 打开ecmp控制后台,并在应用管理->互动编辑器->权益查询设置->添加,配置对应URL;见下图1。

  3. 创建互动作品并进入互动编辑器;

  4. 在编辑器 基础设置->参与条件设置->权益展示,开启并选择权益接口即可。

    权益接口配置

  5. 最终展示

接口规范

  • 方法类型:POST

  • Content-Type:application/json

  • 接口入参

    参数名 是否必须 参数类型 参数说明
    nonce String 随机字符串
    timestamp Long 当前 UNIX 时间戳,可记录发起 API 请求的时间。例如1529223702
    signature String 请求签名。
    msgEncrypt String 数据明细,不同业务类型,数据格式不一样
  • msgEncrypt解密数据格式

    参数名 是否必须 参数类型 参数说明
    id Number 作品id
    code String 作品code
    mobile String 手机号(手机授权模式)
    openId String 1.对接方访客唯一Id(自定义授权模式)
    2.微信openId(微信授权模式)
    nickName String 微信昵称(微信授权模式)
    corpOpenId String 企业openId,平台型企业使用
    customLotteryParams obj 如果同时启用了自定义规则且设置了消耗和门槛,这里会携带所设置的参数
  • 接口返回值
    至少包含code和msg参数。

    {
      "code": "200",
        "msg": "ok",
        "obj": {
          "benefitShowDesc": "剩余100积分"
        }
    }
    
    参数名 是否必须 参数类型 参数说明
    code String 200请求正确,其他视为失败
    msg String 错误描述
    obj.benefitShowDesc String 权益描述,限制50个字。超出后,截取前50字。

will 2025年3月18日 16:21 5409 收藏文档