淘宝开放平台

登录
文档中心 > API类目 > 营销API

营销API

tmall.promotag.taguser.save (给用户打上优惠标签)

给用户载体打标

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tag_id Number 必须 12345 标签ID
nick String 可选 测试 昵称
ouid String 可选 123456 用户ID
openid String 可选 123456 用户ID

响应参数

名称 类型 示例值 描述
is_success Boolean true 打标结果是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallPromotagTaguserSaveRequest req = new TmallPromotagTaguserSaveRequest();
req.setTagId(12345L);
req.setNick("测试");
req.setOuid("123456");
req.setOpenid("123456");
TmallPromotagTaguserSaveResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
<tmall_promotag_taguser_save_response>
    <is_success>true</is_success>
</tmall_promotag_taguser_save_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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-error TOPAPI调用失败 TOPAPI调用失败
isv.invalid-parameter 参数信息为空或信息不完整 参数填充完整
isv.invalid-carrier 标签载体即打标用户信息错误 用户不存在或无效
isv.invalid-tag 标签错误 标签不存在或已失效
isv.without-permission 无操作标签的权限 无操作标签的权限
isv.exceed-max-tag-count 超出了用户可使用的最大标签数1000 超出了用户可使用的最大标签数1000

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部