alibaba.kbcpa.distribute.items.get (本地生活口碑CPA分销媒体商品列表页)

本地生活口碑CPA分销媒体商品列表页查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trace_id String 可选 0bb4822716049032008845564ea27d 商品列表请求,第一次请求不传,后续将返回结果里的traceId带入即可,既是一次完整的翻页操作
sec_track_id String 可选 xxxxx 二级渠道id
city_id String 必须 023232 口碑城市id
longitude String 必须 127.42323 经度
latitude String 必须 33.323332 纬度
limit Number 必须 10 每页数量,最终返回结果数可能小于limit
skip Number 必须 0 第一次传0,后面翻页传参尽量用返回值里的nextSkip

响应参数

名称 类型 示例值 描述
result ResultDTO ResultDTO 异步获取历史数据接口返回结果
  • └ success
  • Boolean
  • true
  • 执行结果
  • result
  • KbCpaModel
  • KbCpaModel
  • 接口返回类型
  • kb_cpa_items
  • KbCpaItemDTO []
  • KbCpaItemDTO
  • 商品数据底层
  • └ cnid
  • String
  • rfdsrwe
  • 计划id
  • └ aid
  • String
  • dadasweq
  • 广告主id
  • └ total_sales
  • String
  • 442
  • 总销量
  • └ original_price
  • String
  • 174.5元
  • 原始出价
  • └ price
  • String
  • 114.5元
  • 现价
  • └ sub_title
  • String
  • 口碑子标题
  • 口碑子标题
  • └ title
  • String
  • 口碑标题
  • 口碑标题
  • └ cover
  • String
  • https://img.alicdn.com/i3/2200798722917/O1CN01Z2QLds1XQ1u1IGGmy_!!2200798722917-0-koubei.jpg
  • 封面图
  • └ wx_app_id
  • String
  • 微信跳转小程序id
  • 微信跳转小程序id
  • └ path
  • String
  • 微信跳转页面路径
  • 微信跳转页面路径
  • └ tb_item_id
  • String
  • 淘宝商品id
  • 淘宝商品id
  • └ commission
  • String
  • 预期总佣金
  • 单位分
  • └ trace_id
  • String
  • 0bb4822716049032008845564ea27d
  • 一套翻页动作的唯一标示
  • └ has_next
  • Boolean
  • true
  • 是否有下一页
  • └ next_skip
  • Number
  • 100
  • 下一次翻页的游标
  • └ error_code
  • String
  • 500
  • 错误码
  • └ error_msg
  • String
  • 系统异常
  • 错误原因

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaKbcpaDistributeItemsGetRequest req = new AlibabaKbcpaDistributeItemsGetRequest();
req.setTraceId("0bb4822716049032008845564ea27d");
req.setSecTrackId("xxxxx");
req.setCityId("023232");
req.setLongitude("127.42323");
req.setLatitude("33.323332");
req.setLimit(10L);
req.setSkip(0L);
AlibabaKbcpaDistributeItemsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_kbcpa_distribute_items_get_response>
    <result>
        <success>true</success>
        <result>
            <kb_cpa_items>
                <kb_cpa_item_d_t_o>
                    <cnid>rfdsrwe</cnid>
                    <aid>dadasweq</aid>
                    <total_sales>442</total_sales>
                    <original_price>174.5元</original_price>
                    <price>114.5元</price>
                    <sub_title>口碑子标题</sub_title>
                    <title>口碑标题</title>
                    <cover>https://img.alicdn.com/i3/2200798722917/O1CN01Z2QLds1XQ1u1IGGmy_!!2200798722917-0-koubei.jpg</cover>
                    <wx_app_id>微信跳转小程序id</wx_app_id>
                    <path>微信跳转页面路径</path>
                    <tb_item_id>淘宝商品id</tb_item_id>
                    <commission>预期总佣金</commission>
                </kb_cpa_item_d_t_o>
            </kb_cpa_items>
            <trace_id>0bb4822716049032008845564ea27d</trace_id>
            <has_next>true</has_next>
            <next_skip>100</next_skip>
        </result>
        <error_code>500</error_code>
        <error_msg>系统异常</error_msg>
    </result>
</alibaba_kbcpa_distribute_items_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部