活动信息添加/更新

开发之前请创建腾讯数据接入数据源 （dataSourceId），可将 dataSourceId 理解为数据的集合。创建一个数据仓库后，所有接口传输数据时都可重复使用。

请求地址

域名/data-api/v1/order/add_promotion

请求方法

POST

请求参数

参数名	样例	描述
app_id	abc	分配的app_id
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	请求时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求体类型

application/json

请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
promotions	array	Y	促销列表数组最大长度 50
external_promotion_id	string	Y	您为促销活动分配的唯一 id。一般而言，是您在商品库为该促销活动分配的 id。字段长度最小 1 字节，长度最大 100 字节
promotion_name	string	Y	促销名称字段长度最小 1 字节，长度最大 100 字节
promotion_description	string		促销描述字段长度最大 100 字节
promotion_type	integer	Y	促销类型描述字段长度最小 1 字节，长度最大 100 字节，10001：秒杀
promotion_status	integer	Y	活动状态1：启用；2：停用
channels	integer	Y	活动渠道列表字段长度最小 1 字节，1：商家小程序；2：商家app；3：商家H5；4：商家pcweb；5：线下人工pos；6：线下自助收银；99：其他
promotion_url	string		促销活动 url字段长度最大 100 字节
start_time	string	Y	活动开始时间，时间戳，毫秒
end_time	string	Y	活动结束时间，时间戳，毫秒
promotion_salesinfo	array	Y	参与店仓的列表
external_store_id	string	Y	店仓分配的唯一ID
external_sku_id	string	Y	商品SKU分配的唯一ID
promotion_price	float	Y	活动的促销价格

请求体示例

{
    "dataSourceId": "105",
    "promotions": [
        {
            "external_promotion_id": "895420584093285",
            "promotion_name": "秒杀",
            "promotion_description": "双十一百亿补贴",
            "promotion_type": 10001,
            "promotion_status": 1,
            "channels": 1,
            "promotion_url": "pages/promotion/promotion_id=895420584093285",
            "start_time": "1572395131732",
            "end_time": "1572396131732",
            "promotion_salesinfo": [{
                "external_store_id": "9L11",
                "external_sku_id": "681JJ7250200G2402",
                "promotion_price": 19.00
            }]
        }
    ]
}

应答体结构

名称	类型	描述
retcode	integer	返回码
errmsg	string	错误信息
data	json object	响应内容

应答示例

{
  "retcode":0,
  "errmsg":"",
  "data": {}
}