文档中心 > API类目 > 海外-淘宝客API

taobao.ovs.tbk.item.convert (海外淘宝客-推广者-商品链接转换)

海外淘宝客商品链接转换

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
unid String 可选 123 渠道自定义参数
num_iids String 必须 123,456 商品ID串,用','分割,从taobao.tbk.item.get接口获取num_iid字段,最大40个
adzone_id Number 必须 123 广告位ID,区分效果位置

响应参数

名称 类型 示例值 描述
items ItemDTOS [] 淘宝客商品
  • └ num_iid
  • String
  • 1234
  • 商品ID
  • └ click_url
  • String
  • http://s.click.taobao.com/e=xxx
  • 淘客推广链接,有券返回券二合一页面链接;无券返回基础推广链接
  • └ basic_url
  • String
  • http://s.click.taobao.com/e=xxx
  • 淘客推广链接,返回基础推广链接

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkItemConvertRequest req = new OvsTbkItemConvertRequest();
req.setUnid("123");
req.setNumIids("123,456");
req.setAdzoneId(123L);
OvsTbkItemConvertResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_item_convert_response>
    <items>
        <item_d_t_o_s>
            <num_iid>1234</num_iid>
            <click_url>http://s.click.taobao.com/e=xxx</click_url>
            <basic_url>http://s.click.taobao.com/e=xxx</basic_url>
        </item_d_t_o_s>
    </items>
</ovs_tbk_item_convert_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>

错误码解释

错误码 错误描述 解决方案
504 ILLEGAL_INPUT_ITEM_IDS 请检查入参item_id值
505 ILLEGAL_INPUT_UNID 请检查入参UNID值是否正常
501 ILLEGAL_INPUT_ADZONE_ID 请检查入参adzone_id值
500 MIX ERROR 请检查adzone_id值是否有效或者海外开放平台taobao user id和海外联盟平台不一致
0 SYSTEM_ERROR 请重试
400

API工具

如何获得此API

FAQ

返回
顶部