淘宝开放平台

登录
文档中心 > API类目 > 拍卖API

拍卖API

taobao.auction.zc.pulicity.list (查询处置公告或工作公示列表)

查询处置公告或工作公示列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
publicity_list_query_dto PublicityListQueryDTO 可选 查询请求
  • └ publish_start_time_str
  • String
  • 可选
  • 2025-01-21 00:00:00
  • 创建公告的起始时间，格式：yyyy-MM-dd HH:mm:ss
  • └ publish_end_time_str
  • String
  • 可选
  • 2025-01-21 16:00:00
  • 创建公告的结束时间，格式：yyyy-MM-dd HH:mm:ss
  • └ page_size
  • Number
  • 可选
  • 10
  • 当页条数
  • └ page
  • Number
  • 可选
  • 1
  • 页码
  • └ proxy_nick
  • String
  • 必须
  • 拍卖测试帐号
  • 机构淘宝账号昵称
  • └ types
  • String []
  • 必须
  • [24]
  • 公告类型列表
  • └ query_child
  • Boolean
  • 可选
  • false
  • 是否同时查询子机构数据

响应参数

名称 类型 示例值 描述
result_code String SYSTEM_ERROR 错误code
result_msg String 系统异常 错误描述
value PublicityTopVO [] 公告信息列表
  • └ type
  • Number
  • 24
  • 公告类型
  • └ type_desc
  • String
  • 处置公告
  • 公告类型描述
  • └ publicity_id
  • Number
  • 15407
  • 公告ID
  • └ title
  • String
  • 测试公告
  • 公告标题
  • └ publish_time
  • Number
  • 1737446921000
  • 发布时间戳，毫秒
  • └ status
  • Number
  • 1
  • -1:已删除 1:已发布 2:已撤回
  • └ cancel_time
  • Number
  • 1737446921000
  • 撤回时间戳，毫秒

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcPulicityListRequest req = new AuctionZcPulicityListRequest();
AuctionZcPulicityListRequest.PublicityListQueryDTO obj1 = new AuctionZcPulicityListRequest.PublicityListQueryDTO();
obj1.setPublishStartTimeStr("2025-01-21 00:00:00");
obj1.setPublishEndTimeStr("2025-01-21 16:00:00");
obj1.setPageSize(10L);
obj1.setPage(1L);
obj1.setProxyNick("拍卖测试帐号");
obj1.setTypes("24");
obj1.setQueryChild(false);
req.setPublicityListQueryDto(obj1);
AuctionZcPulicityListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<auction_zc_pulicity_list_response>
    <result_code>SYSTEM_ERROR</result_code>
    <result_msg>系统异常</result_msg>
    <value>
        <publicity_top_v_o>
            <type>24</type>
            <type_desc>处置公告</type_desc>
            <publicity_id>15407</publicity_id>
            <title>测试公告</title>
            <publish_time>1737446921000</publish_time>
            <status>1</status>
            <cancel_time>1737446921000</cancel_time>
        </publicity_top_v_o>
    </value>
</auction_zc_pulicity_list_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部