创建奖品

调用方式

  • 请求方式: POST
  • 请求地址: https://tls2s.allapp.link/manage/campaign/reward_store?project_id=你的ProjectId

请求头参数(Header)

参数必须说明
Content-Typeapplication/json声明json格式
AuthorizationBearer md5(OpenSecret+(空格)+md5(请求body))OpenSecret 获取方式:Dashboard > 开发配置 > 开放平台秘钥 获取OpenSecret

请求内容参数(Body)

请求示例:

{
    "reward_title": "奖品标题",
    "receive_type": 1,
    "url_id": "2465898765467473827",
    "contact": "",
    "kv_data": [
        {
            "key": "key1",
            "value": "value1",
            "is_show": 0,
        },
        {
            "key": "key2",
            "value": "value2",
            "is_show": 0,
        }
    ],
    "langs": [
        {
            "mark": "zh",
            "title": "奖品名称",
            "img_url": "https://imgurl.png",
            "image_id": "2465898765467473833",
            "is_default": 1,
            "web_url": "https://jumppage.com?id=kjn34",
            "app_param": ""
        },
        {
            "mark": "en",
            "title": "reward name",
            "image_id": "2465898765467473832",
            "is_default": 0,
            "web_url": "",
            "app_param": "s=3&g=k"
        }
    ],
    "created_at": 1729492992,
}

参数说明

参数必须类型说明
project_idstring项目id
reward_titlestring奖品标题(后台统一展示的奖品信息,不传使用默认语言的奖品标题)
receive_typenumber发放类型(1-系统发放,2-联系客服)
url_idstring回调地址id(系统发放必填)
contactstring联系客服方式(联系客服必填)
kv_dataarray(object)键值数据(系统发放必填)
kv_data.keystring
kv_data.valuestring
kv_data.is_shownumber是否需要展示给C端用户查看(0-否,1-是)
langsarray(object)语言数据
langs.markstring语言标识
langs.titlestring奖品名称
langs.image_idstring图片id
langs.is_defaultnumber当奖品语言未能支持活动时选择当前奖品(0-否,1-是)
langs.web_urlstringWeb端的跳转地址
langs.app_paramstringApp端的监听参数

返回示例

{
    "code": 200,
    "msg": "请求成功",
    "data": {
        "reward_id": "2465898765467473827"
    }
}

返回参数说明

参数类型说明
codenumber返回状态码 200为成功返回
msgstring返回状态码信息
dataobject返回内容
data.reward_idstring奖品id