COMMIND

Appearance

应用接入相关（活悦 -> 应用） ​

1 功能描述 ​

【活悦平台】 -> 【各个应用】

云平台发起调用，需要应用实现对应接口，根据应用提供的回调接口路径

租户端上下架/删除/复制活动，将操作同步各个活动

2 请求方式 ​

POST

3 请求路径 ​

回调接口路径{}+签名信息参数

如接口路径：https://test-act.tmuyun.com/coupon/api/callback

完整请求url：https://test-act.tmuyun.com/coupon/api/callback?ak=f6RTePJl5ihPNklt&timestamp=1696923990000&sign=sk91mkxoos2mx02jkslsi2ms&requestId=123456

4 请求参数 ​

4.1 Header 参数 ​

参数名必选类型/参数值说明
Content-Type是application/json请求参数类型

4.2 Query公共参数 ​

  • 每次请求必须携带
参数名必选类型/参数值说明
ak是String应用ak
timestamp是Long时间戳，毫秒
requestId是String唯一请求ID，随机生成
sign是String签名 = md5加密（参数1名 = 参数1值 & 参数2名 = 参数2值...） 签名key按照此顺序: ak、timestamp、requestId、sk 例如：sign = md5(ak={0}&timestamp={1}&requestId={2}&sk={3})

4.3 Body 参数 ​

  • 主要分为【type】和【data】2部分数据
  • type用于控制接口类型
  • data用户传输该接口具体参数
json
type:
1：活动上架
2：活动下架
3：活动复制
4：活动删除

4.3.1活动上架 ​

json
{
    "type":1, // 类型
    "data"："{\"spaceId\":1, \"thirdId\":1, \"spaceActivityId\":1 }" // JSON字符串
}

data内容：
{
    "spaceId":1, // 空间ID
    "thirdId":1, // 第三方活动ID，应用自己的活动ID
    "spaceActivityId":1 // 空间活动ID
}

4.3.2 活动上架 ​

json
{
    "type":1, // 类型
    "data"："{\"spaceId\":1, \"thirdId\":1, \"spaceActivityId\":1 }" // JSON字符串
}

data内容：
{
    "spaceId":1, // 空间ID
    "thirdId":1, // 第三方活动ID，应用自己的活动ID
    "spaceActivityId":1 // 空间活动ID
}

#### 4.3.3 活动复制(功能下架，无需实现！)

json
{
    "type":1, // 类型
    "data"："{\"spaceId\":1, \"thirdId\":1, \"spaceActivityId\":1,\"channelList\": [{\"channelId\": 0, \"channelType\": 0, \"channelName\": \"string\", \"realPerson\": true } ] }" // JSON字符串
}

data内容：
{
    "spaceId":1, // 空间ID
    "thirdId":1, // 第三方活动ID，应用自己的活动ID
    "spaceActivityId":1, // 空间活动ID
    "channelList":[
    {
        "channelId": 1,     // 渠道ID
        "channelType": 1,    // 渠道类型
        "channelName": "string", // 渠道名称
        "realPerson": true  // 是否实人认证
    }
  ]
}

4.3.4 活动删除 ​

json
{
    "type":1, // 类型
    "data"："{\"spaceId\":1, \"thirdId\":1, \"spaceActivityId\":1 }" // JSON字符串
}

data内容：
{
    "spaceId":1, // 空间ID
    "thirdId":1, // 第三方活动ID，应用自己的活动ID
    "spaceActivityId":1 // 空间活动ID
}

5 返回参数 ​

json
{
    "message": "success", // 错误时，返回错误信息
    "success": true // 是否成功
}