淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
update_request	UpdateBenefitActivityRequest	必须			修改关联的权益的活动请求
add_detail_vos ActivityBenefitDetailVo [] 可选活动关联的权益信息，可以从权益选择器API中获取 └ benefit_id Number 可选 123 权益ID └ benefit_type String 可选 demo 权益类型 benefit_activity_vo UpdateBenefitActivityVo 必须同步权益活动的概述信息，方便卖家后台查看 └ activity_url String 可选 demo ISV活动的活动地址 └ desc String 可选 demo 活动描述 └ name String 可选 demo 活动名称 └ relation_id Number 必须 123 ISV活动关联权益后获得的关联ID delete_detail_vos DeleteActivityBenefitDetailVo [] 可选需要删除的已经关联的权益 └ id Number 可选 123 活动关联权益后生产的详情ID

名称	类型	示例值	描述
is_success	Boolean	true	更新是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionBenefitActivityUpdateRequest req = new PromotionBenefitActivityUpdateRequest();
PromotionBenefitActivityUpdateRequest.UpdateBenefitActivityRequest obj1 = new PromotionBenefitActivityUpdateRequest.UpdateBenefitActivityRequest();
List<PromotionBenefitActivityUpdateRequest.ActivityBenefitDetailVo> list3 = new ArrayList<PromotionBenefitActivityUpdateRequest.ActivityBenefitDetailVo>();
PromotionBenefitActivityUpdateRequest.ActivityBenefitDetailVo obj4 = new PromotionBenefitActivityUpdateRequest.ActivityBenefitDetailVo();
list3.add(obj4);
obj4.setBenefitId(123L);
obj4.setBenefitType("demo");
obj1.setAddDetailVos(list3);
PromotionBenefitActivityUpdateRequest.UpdateBenefitActivityVo obj5 = new PromotionBenefitActivityUpdateRequest.UpdateBenefitActivityVo();
obj5.setActivityUrl("demo");
obj5.setDesc("demo");
obj5.setName("demo");
obj5.setRelationId(123L);
obj1.setBenefitActivityVo(obj5);
List<PromotionBenefitActivityUpdateRequest.DeleteActivityBenefitDetailVo> list7 = new ArrayList<PromotionBenefitActivityUpdateRequest.DeleteActivityBenefitDetailVo>();
PromotionBenefitActivityUpdateRequest.DeleteActivityBenefitDetailVo obj8 = new PromotionBenefitActivityUpdateRequest.DeleteActivityBenefitDetailVo();
list7.add(obj8);
obj8.setId(123L);
obj1.setDeleteDetailVos(list7);
req.setUpdateRequest(obj1);
PromotionBenefitActivityUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<promotion_benefit_activity_update_response>
    <is_success>true</is_success>
</promotion_benefit_activity_update_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>

错误码	错误描述	解决方案
isp.service-unknown-error:108	捕获的一些未预知的错误异常。	稍后重试，如果仍然失败可联系接口开发排查。
isp.thread-limit:102	接口访问量过大被流控。	降低访问频率或者等系统空闲时候访问。
isp.service-unknown-error:101	捕获的一些未预知的错误异常。	稍后重试，如果仍然失败可联系接口开发排查。
isp.service-unknown-error:248	捕获的一些未预知的错误异常。	稍后重试，如果仍然失败可联系接口开发排查。
isv.invalid-parameter:293	活动URL过长	不能超过100个字符
isv.invalid-parameter:291	活动名称过长	不能超过40个字符
isv.invalid-parameter:258	更新的关联活动不存在	传入有效的活动关联ID
isv.invalid-parameter:256	活动关联的权益超过5个，请先删除再添加	删除多余的关联权益
isv.invalid-parameter:292	活动描述过长	不能超过256个字符
isv.invalid-parameter:259	关联了无效权益	关联的权益已经删除或者已过期

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

营销API

taobao.promotion.benefit.activity.update (修改关联的活动权益)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ