淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
add_on_items	String	可选	pBdZOatxtA2JAatxRHptm-M8X3qWt4MK8mpxtB	凑单商品id，多个英文逗号分隔
boom_start_time	Date	可选	2023-01-01 00:00:00	优惠价开始时间
boom_end_time	Date	可选	2023-01-01 00:00:00	优惠价结束时间
text_materials	String	必须	文字素材	素材文字部分
cont_id	String	可选	媒体内容Id	媒体内容Id
price_tag	String	可选	全网好价	价格力标签
title	String	必须	奥妙洗衣液50g*2瓶优惠价9.9元	爆料标题
discount_rank	String	可选	A	折扣等级
professional_tag	Number	可选	0	官方ip标签 0-88vip，1-淘金币，2-百亿补贴，3-天猫超市，4-天猫国际自营
scene	Number	必须	1	场景id。1:优惠导购-一淘特供 2:优惠导购-一淘 3:优惠导购-淘宝联盟-社群 4:优惠导购-淘宝联盟-朋友圈 5:优惠导购-淘宝联盟-APP 6:优惠导购-淘宝联盟 7:推广素材-淘宝联盟
item_discount_count	Number	可选	2	优惠价格主商品需购件数
positive_feedback_count	Number	可选	100	点赞数（值）
offline_code	Number	可选	0	下线操作字段，该字段入参表示内容失效不可继续使用，仅限修改入参，首次上传不可传入。 0-已涨价 1-售罄 2-失效 3-其他需下架原因
boom_price	String	可选	9.99	爆料价格（两位小数）
boom_type	Number	必须	1	爆料类型 1：商品；2：活动
content_type	Number	必须	1	内容类型，1：实时单 2：预告单
price_structure	String	可选	买2件打5折	价格实现方式
publisher_nick_name	String	可选	每日好物推荐	原作者昵称
negative_feedback_count	Number	可选	100	点踩数（不值）
origin_time	Date	可选	2023-01-01 00:00:00	原作者发布时间
content_tag	String	可选	母婴好物	内容标签
pre_commission_rate	String	可选	15	预告佣金率，仅预告单可传入
coupon_url	String	可选	https://uland.taobao.com	优惠券链接
selling_point	String	可选	有效除菌，气味清新	商品卖点
boom_id	Number	可选	855	爆料id，当接口操作为“2：更新”必传
item_id	String	可选	qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9	商品id，爆料类型为“1：商品”时必传
activity_url	String	可选	https://s.click.taobao.com	活动链接，爆料类型为“2：活动”时必传
pic_materials	String	必须	abc	素材图片部分，base64编码，多张用英文逗号分隔
publisher_avatar	String	可选	abc	原作者头像，base64编码
operation	Number	必须	2	接口操作，1：上传，2：更新
pre_view_pic	String	可选	abc	商品预览图，base64编码
content_generate_type	Number	可选	1	1：UGC 2：MGC

名称	类型	示例值	描述
data	BoomContentResultDTO		结果出参
boom_content_dto BoomContentDTO 单个爆料内容 └ boom_id Number 855 爆料id └ operation Number 1 操作类型，1-上传；2-更新
result_code	Number	500	异常code
biz_error_desc	Number	审核中数据不可更改	业务异常描述
result_msg	String	内部服务发生错误	异常描述
biz_error_code	Number	2056	业务异常code

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkContentMaterialSaveRequest req = new TbkContentMaterialSaveRequest();
req.setAddOnItems("pBdZOatxtA2JAatxRHptm-M8X3qWt4MK8mpxtB");
req.setBoomStartTime(StringUtils.parseDateTime("2023-01-01 00:00:00"));
req.setBoomEndTime(StringUtils.parseDateTime("2023-01-01 00:00:00"));
req.setTextMaterials("文字素材");
req.setContId("媒体内容Id");
req.setPriceTag("全网好价");
req.setTitle("奥妙洗衣液50g*2瓶优惠价9.9元");
req.setDiscountRank("A");
req.setProfessionalTag(0L);
req.setScene(1L);
req.setItemDiscountCount(2L);
req.setPositiveFeedbackCount(100L);
req.setOfflineCode(0L);
req.setBoomPrice("9.99");
req.setBoomType(1L);
req.setContentType(1L);
req.setPriceStructure("买2件打5折");
req.setPublisherNickName("每日好物推荐");
req.setNegativeFeedbackCount(100L);
req.setOriginTime(StringUtils.parseDateTime("2023-01-01 00:00:00"));
req.setContentTag("母婴好物");
req.setPreCommissionRate("15");
req.setCouponUrl("https://uland.taobao.com");
req.setSellingPoint("有效除菌，气味清新");
req.setBoomId(855L);
req.setItemId("qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9");
req.setActivityUrl("https://s.click.taobao.com");
req.setPicMaterials("abc");
req.setPublisherAvatar("abc");
req.setOperation(2L);
req.setPreViewPic("abc");
req.setContentGenerateType(1L);
TbkContentMaterialSaveResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<tbk_content_material_save_response>
    <data>
        <boom_content_dto>
            <boom_id>855</boom_id>
        </boom_content_dto>
        <operation>1</operation>
    </data>
    <result_code>500</result_code>
    <biz_error_desc>审核中数据不可更改</biz_error_desc>
    <result_msg>内部服务发生错误</result_msg>
    <biz_error_code>2056</biz_error_code>
</tbk_content_material_save_response>

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

淘宝客API

taobao.tbk.content.material.save (淘宝客-公用-爆料分享物料上传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ