taobao.auction.zc.merchantnotice.list (查询机构下招商公告列表)

查询机构下招商公告列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 测试卖家 卖家淘宝nick
start_date Date 可选 2021-01-01 00:00:00 创建招商公告起始时间,可以为空
end_date Date 可选 2021-02-01 00:00:00 创建招商公告结束时间,可以为空
page_no Number 可选 1
  • 默认值:1
  • 页码,不填默认为1
    page_size Number 可选 40
  • 默认值:40
  • 每页大小,不填默认为40,最大40
    location_code Number 可选 330101 区域code(国标6位)
    cat_id Number 可选 1231332324 资产类型id(发布接口里的type字段),枚举值:房产-123564002 土地-123576001 机动车-123578001 机械设备-123580001 知识产权-123582001 债权-123584002 股权-123586001 矿权-126242006 林权-126252003 工程-126332001 其他资产-123582002
    query_child Boolean 可选 true
  • 默认值:false
  • 是否关联查询子机构数据

    响应参数

    名称 类型 示例值 描述
    result Result4Top 返回结果
    • └ total_item
    • Number
    • 100
    • 总记录数
    • └ total_page
    • Number
    • 5
    • 总页数
    • └ error_code
    • String
    • isv.system-error
    • 错误码
    • └ page_size
    • Number
    • 40
    • 页大小
    • └ current_page
    • Number
    • 1
    • 当前页
    • value
    • MerchantSimpleDTO []
    • 招商推介列表
    • 招商推介列表
    • └ id
    • Number
    • 12345
    • 招商推介id
    • └ title
    • String
    • 测试招商推介标题
    • 招商推介标题
    • └ main_pic_url
    • String
    • https://img.alicdn.com/imgextra/i4/O1CN01Nza0kT1sXuXwgduP0_!!0-paimai.jpg
    • 招商推介主图(第一张图片)
    • └ lower_price
    • String
    • 10000
    • 参考价值下限,可能为空,单位:元
    • └ upper_price
    • String
    • 30000
    • 参考价值上限,可能为空,单位:元
    • └ type_name
    • String
    • 机动车
    • 资产类型: 土地林权,机动车,机械设备等
    • └ status_name
    • String
    • 招商中
    • 状态名称:编辑中,招商中,已转竞价,线下已处理,已过期,已撤回,已删除
    • └ detail_url
    • String
    • https://zc-paimai.taobao.com/zc/mn_detail.htm?id=12345
    • 招商推介url
    • └ location_code
    • Number
    • 330101
    • 区域code
    • └ cat_id
    • Number
    • 3423423423
    • 资产类型id
    • └ address
    • String
    • 浙江省杭州市余杭区
    • 地址,省市区
    • └ status
    • Number
    • 2
    • 状态码:1 编辑中,2 招商中,3 已转竞价,4 线下已处理,5 已过期 6 已撤回,-1 已删除
    • └ errror_msg
    • String
    • 系统错误
    • 错误描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AuctionZcMerchantnoticeListRequest req = new AuctionZcMerchantnoticeListRequest();
    req.setNick("测试卖家");
    req.setStartDate(StringUtils.parseDateTime("2021-01-01 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("2021-02-01 00:00:00"));
    req.setPageNo(1L);
    req.setPageSize(40L);
    req.setLocationCode(330101L);
    req.setCatId(1231332324L);
    req.setQueryChild(true);
    AuctionZcMerchantnoticeListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <auction_zc_merchantnotice_list_response>
        <result>
            <total_item>100</total_item>
            <total_page>5</total_page>
            <error_code>isv.system-error</error_code>
            <page_size>40</page_size>
            <current_page>1</current_page>
            <value>
                <merchant_simple_d_t_o>
                    <id>12345</id>
                    <title>测试招商推介标题</title>
                    <main_pic_url>https://img.alicdn.com/imgextra/i4/O1CN01Nza0kT1sXuXwgduP0_!!0-paimai.jpg</main_pic_url>
                    <lower_price>10000</lower_price>
                    <upper_price>30000</upper_price>
                    <type_name>机动车</type_name>
                    <status_name>招商中</status_name>
                    <detail_url>https://zc-paimai.taobao.com/zc/mn_detail.htm?id=12345</detail_url>
                    <location_code>330101</location_code>
                    <cat_id>3423423423</cat_id>
                    <address>浙江省杭州市余杭区</address>
                    <status>2</status>
                </merchant_simple_d_t_o>
            </value>
            <errror_msg>系统错误</errror_msg>
        </result>
    </auction_zc_merchantnotice_list_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

    返回
    顶部