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

taobao.tbk.sc.optimus.promotion (淘宝客-服务商-权益物料精选)

服务商使用。支持入参推广者对应的“推广位”和官方提供的“权益物料id”,获取指定权益物料。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 10
  • 默认值:10
  • 页大小,每次请求限制10以内
    page_num Number 可选 1
  • 默认值:1
  • 第几页,默认:1
    adzone_id Number 必须 123 mm_xxx_xxx_xxx的第3段数字
    promotion_id Number 必须 123 官方提供的权益物料Id。有价券-37104、大额店铺券-37116、天猫店铺券-62191、券券补-61809 更多权益物料id敬请期待!
    site_id Number 必须 111 mm_xxx_xxx_xxx的第2段数字

    响应参数

    名称 类型 示例值 描述
    result_list MapData [] resultList
    • └ promotion_type
    • String
    • 1
    • 权益类型。1 有价券(需要购买的店铺券或单品券) 2 公开券(直接领取的店铺券或单品券) 3 妈妈券(妈妈渠道领取的店铺券或单品券) 4.品类券 (跨店可用券,可与1,2,3叠加)
    • └ condition_type
    • String
    • 1
    • 优惠门槛类型: 1 满元 2 满件
    • └ discount_type
    • String
    • 1
    • 优惠类型: 1 减钱 2 打折
    • └ total_count
    • Number
    • 50
    • 权益信息-总量(权益初始库存量)
    • └ remain_count
    • Number
    • 20
    • 权益信息-剩余库存(权益剩余库存量)
    • └ display_start_time
    • String
    • 1559232000000
    • 权益信息展示开始时间,精确到毫秒时间戳
    • └ display_end_time
    • String
    • 1559750399000
    • 权益信息展示结束时间,精确到毫秒时间戳
    • promotion_list
    • PromotionList []
    • 权益信息
    • └ entry_used_start_time
    • String
    • 1559232000000
    • 权益开始时间,精确到毫秒时间戳
    • └ entry_used_end_time
    • String
    • 1559750399000
    • 权益结束时间,精确到毫秒时间戳
    • └ entry_condition
    • String
    • 100
    • 权益起用门槛,满X元可用,券场景为满元,精确到分,如满100元可用
    • └ entry_discount
    • String
    • 30
    • 权益面额,券场景为减钱,精确到分
    • promotion_extend
    • PromotionExtend
    • 权益扩展信息
    • recommend_item_list
    • RecommendItemList []
    • 权益推荐商品
    • └ item_id
    • Number
    • 123456
    • 权益推荐商品id
    • └ url
    • String
    • //s.click.taobao.com/xxx
    • 商品链接
    • youjia_coupon_info
    • Youjiacouponinfo
    • 有价券信息
    • └ item_id
    • String
    • 123456
    • 有价券商品id
    • └ url
    • String
    • //s.click.taobao.com/xxx
    • 商品链接
    • └ promotion_url
    • String
    • https://uland.taobao.com/quan/xxx
    • 权益链接
    • └ seller_id
    • String
    • 123
    • 店铺信息-卖家ID
    • └ nick
    • String
    • XXX专营店
    • 店铺信息-卖家昵称
    • └ shop_title
    • String
    • XXX旗舰店
    • 店铺信息-店铺名称
    • └ shop_picture_url
    • String
    • 图片url
    • 店铺信息-店铺logo

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkScOptimusPromotionRequest req = new TbkScOptimusPromotionRequest();
    req.setPageSize(10L);
    req.setPageNum(1L);
    req.setAdzoneId(123L);
    req.setPromotionId(123L);
    req.setSiteId(111L);
    TbkScOptimusPromotionResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_sc_optimus_promotion_response>
        <result_list>
            <map_data>
                <promotion_type>1</promotion_type>
                <condition_type>1</condition_type>
                <discount_type>1</discount_type>
                <total_count>50</total_count>
                <remain_count>20</remain_count>
                <display_start_time>1559232000000</display_start_time>
                <display_end_time>1559750399000</display_end_time>
                <promotion_list>
                    <promotion_list>
                        <entry_used_start_time>1559232000000</entry_used_start_time>
                        <entry_used_end_time>1559750399000</entry_used_end_time>
                        <entry_condition>100</entry_condition>
                        <entry_discount>30</entry_discount>
                    </promotion_list>
                </promotion_list>
                <promotion_extend>
                    <recommend_item_list>
                        <recommend_item_list>
                            <item_id>123456</item_id>
                            <url>//s.click.taobao.com/xxx</url>
                        </recommend_item_list>
                    </recommend_item_list>
                    <youjia_coupon_info>
                        <item_id>123456</item_id>
                        <url>//s.click.taobao.com/xxx</url>
                    </youjia_coupon_info>
                    <promotion_url>https://uland.taobao.com/quan/xxx</promotion_url>
                </promotion_extend>
                <seller_id>123</seller_id>
                <nick>XXX专营店</nick>
                <shop_title>XXX旗舰店</shop_title>
                <shop_picture_url>图片url</shop_picture_url>
            </map_data>
        </result_list>
    </tbk_sc_optimus_promotion_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工具

    如何获得此API

    FAQ

    返回
    顶部