腾讯有数官方文档

创建活动信息数据源

请求接口:

/data-api/v1/order/create_promotion_data_source

等价接口:/data-api/v1/data_source/add(具体请查看数据源文档)

请求方法:

POST

请求参数:

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

请求体类型:

application/json

请求体参数:

参数名 类型 描述
merchantId string 商家id

响应体结构:

参数名 二级字段 类型 描述
retcode integer 返回码
errmsg string 错误信息
data json object 响应内容
dataSource DataSource 数据源

请求示例:

curl 'https://域名/data-api/v1/order/create_promotion_data_source?app_id=abc&nonce=61794670f155b&sign=sha256&timestamp=1569232087&signature=aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5' \
-X POST \
-H 'Content-Type: application/json' \
-d '{
  "merchantId":"123"
}'

响应示例:

{
  "retcode":0,
  "errmsg":"",
  "data" {
    "dataSource": {
      "id": "105",
      "type": 4,
      "merchantId": "123"
    }
  }
}

添加活动信息

请求接口:

/data-api/v1/order/add_promotion

请求方法:

POST

请求参数:

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

请求体类型:

application/json

请求体参数:

参数字段描述链接

响应体结构:

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

请求示例:

{
    "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":0,
	"errmsg":"",
	"data": {}
}