文档中心 > API类目 > 万相台无界API

taobao.universalbp.new.material.find.spot (分页查询看点信息)

分页查询看点信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
spot_query_v_o SpotQueryVO 必须 spotQueryVO
  • └ item_id
  • Number
  • 可选
  • 38232257688
  • 宝贝id
  • └ tag_id
  • Number
  • 可选
  • 40
  • 标签id
  • └ start_time
  • String
  • 可选
  • 2024-08-06
  • 开始时间
  • └ end_time
  • String
  • 可选
  • 2024-08-06
  • 结束时间
  • └ offset
  • Number
  • 可选
  • 10
  • 偏移量
  • └ page_size
  • Number
  • 可选
  • 10
  • 页面大小

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • spot_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • spot_v_o_list
  • SpotVO []
  • 批量成功结果集
  • └ spot_id
  • Number
  • 1
  • 看点id
  • └ material_name
  • String
  • 物料名称
  • 物料名称
  • └ title
  • String
  • 物料标题
  • 物料标题
  • └ link_url
  • String
  • https://h5.m.taobao.com/****timemove
  • 物料的相关链接
  • └ img_url
  • String
  • https://img.alicdn.com/******.jpg
  • 物料的图片URL
  • └ live_id
  • Number
  • 474297730705
  • 直播id
  • └ live_title
  • String
  • 直播间隔一小时抽免单
  • 直播标题
  • └ material_id
  • Number
  • 474847464897
  • 物料id
  • └ status
  • Number
  • 4
  • 状态
  • └ material_type
  • Number
  • 3
  • 类型
  • └ audit_reason
  • String
  • 1
  • 审核未通过的原因
  • └ material_tag_id
  • Number
  • 40
  • 物料标签id
  • └ quantity
  • Number
  • 20
  • 数量
  • └ bid_count
  • Number
  • 20
  • 竞标次数
  • └ item_id
  • Number
  • 474847464777
  • 商品id
  • └ outer_status
  • Number
  • 10
  • 外部状态标识
  • └ live_cover_img
  • String
  • https://gw.alicdn.com/****.jpg
  • 直播的封面URL
  • └ audit_status
  • Number
  • 1
  • 审核状态
  • └ live_start_time
  • Date
  • 2024-08-02 07:44:22
  • 直播开始时间
  • └ video_ori_url
  • String
  • https://livecaing.alicdn.com/*****
  • 视频URL
  • └ pv
  • Number
  • 35
  • 页面浏览量
  • └ trade_amt
  • Number
  • 147
  • 交易金额
  • └ live_start_time_str
  • String
  • 2024-08-02 07:44:22
  • 直播开始时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewMaterialFindSpotRequest req = new UniversalbpNewMaterialFindSpotRequest();
UniversalbpNewMaterialFindSpotRequest.TopServiceContext obj1 = new UniversalbpNewMaterialFindSpotRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewMaterialFindSpotRequest.SpotQueryVO obj2 = new UniversalbpNewMaterialFindSpotRequest.SpotQueryVO();
obj2.setItemId(38232257688L);
obj2.setTagId(40L);
obj2.setStartTime("2024-08-06");
obj2.setEndTime("2024-08-06");
obj2.setOffset(10L);
obj2.setPageSize(10L);
req.setSpotQueryVO(obj2);
UniversalbpNewMaterialFindSpotResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_material_find_spot_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <spot_v_o_top_bulk_data>
            <count>10</count>
            <spot_v_o_list>
                <spot_v_o>
                    <spot_id>1</spot_id>
                    <material_name>物料名称</material_name>
                    <title>物料标题</title>
                    <link_url>https://h5.m.taobao.com/****timemove</link_url>
                    <img_url>https://img.alicdn.com/******.jpg</img_url>
                    <live_id>474297730705</live_id>
                    <live_title>直播间隔一小时抽免单</live_title>
                    <material_id>474847464897</material_id>
                    <status>4</status>
                    <material_type>3</material_type>
                    <audit_reason>1</audit_reason>
                    <material_tag_id>40</material_tag_id>
                    <quantity>20</quantity>
                    <bid_count>20</bid_count>
                    <item_id>474847464777</item_id>
                    <outer_status>10</outer_status>
                    <live_cover_img>https://gw.alicdn.com/****.jpg</live_cover_img>
                    <audit_status>1</audit_status>
                    <live_start_time>2024-08-02 07:44:22</live_start_time>
                    <video_ori_url>https://livecaing.alicdn.com/*****</video_ori_url>
                    <pv>35</pv>
                    <trade_amt>147</trade_amt>
                    <live_start_time_str>2024-08-02 07:44:22</live_start_time_str>
                </spot_v_o>
            </spot_v_o_list>
        </spot_v_o_top_bulk_data>
    </top_result>
</universalbp_new_material_find_spot_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

返回
顶部