通证激励

任务奖励API

URI

POST https://baas.qualink.com/bas/coin/reward/merchant/quest

请求头部

Content-type: application/json
Authorization: 平台用户身份令牌

请求参数

名称 类型 是否必选 实例值 描述
appId String 是 商户AppID
questId String 是 任务ID（由商户在五彩石开放平台维护）
openId String 是 奖励用户, 商户用户在五彩石开放平台的ID
amount String 否 奖励通证数量，默认任务设置的奖励数量，以接口传输为准，支持8位小数点
outUniqueId String 是 商户平台的唯一奖励标识ID
outTitle String 是 奖励说明
pointType String 是 通证类型，支持QCS-五彩石

返回数据

名称 类型 示例 描述
success Boolean true 响应标记
msg String success 提示信息
data String - 奖励JSON数据

实例

请求实例

curl -H 'Content-type: application/json' -H 'Authorization: xxxx' -XPOST https://baas.qualink.com/bas/coin/reward/merchant/quest -d '{"appId": "FB*****SD83", "questId": "79000", "openId": "u****012", "amount": "10.0", "outUniqueId": "outuser2001002010", "outTitle": "签到任务奖励", "pointType": "QCS"}'

返回值解析

{
    "success": true,
    "msg": "任务奖励成功",
    "data": {
        "rewardId": "201991092******92910",
        "appId": "FB*****SD83",
        "questId": "79000",
        "pointType": "QCS",
        "amount": "10.0",
        "outUniqueId": "outuser2001002010"
    }
}