文档中心 > API类目 > 淘宝客API

taobao.tbk.spread.get (淘宝客-公用-长链转短链)

输入一个原始的链接,转换得到指定的传播方式,如二维码,淘口令,短连接; 现阶段只支持短连接。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
requests TbkSpreadRequest [] 必须
  • 最大列表长度:20
  • 请求列表,内部包含多个url
    • └ url
    • String
    • 必须
    • http://temai.taobao.com
    • 原始url, 只支持uland.taobao.com,s.click.taobao.com, ai.taobao.com,temai.taobao.com的域名转换,否则判错

    响应参数

    名称 类型 示例值 描述
    results TbkSpread [] 传播形式对象列表
    • └ content
    • String
    • http://s.click.taobao.com/H4zazPx
    • 传播形式, 目前只支持短链接
    • └ err_msg
    • String
    • OK
    • 调用错误信息;由于是批量接口,请重点关注每条请求返回的结果,如果非OK,则说明该结果对应的content不正常,请酌情处理;
    total_results Number 10 totalResults

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkSpreadGetRequest req = new TbkSpreadGetRequest();
    List<TbkSpreadGetRequest.TbkSpreadRequest> list2 = new ArrayList<TbkSpreadGetRequest.TbkSpreadRequest>();
    TbkSpreadGetRequest.TbkSpreadRequest obj3 = new TbkSpreadGetRequest.TbkSpreadRequest();
    list2.add(obj3);
    obj3.setUrl("http://temai.taobao.com");
    req.setRequests(list2);
    TbkSpreadGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_spread_get_response>
        <results>
            <tbk_spread>
                <content>http://s.click.taobao.com/H4zazPx</content>
                <err_msg>OK</err_msg>
            </tbk_spread>
        </results>
        <total_results>10</total_results>
    </tbk_spread_get_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.dependency-error 依赖服务暂时不可用 稍后重试
    isp.tbkapi-service-unavailable 内部服务不可用 稍后重试
    isv.not-support-param-type 输入参数非法 参考文档

    API工具

    如何获得此API

    FAQ

    返回
    顶部