taobao.auction.zc.jzhk.demandinfo.batchquery (精准获客需求信息查询(支持批量))

精准获客需求信息查询(支持批量),当需求未提交时,返回预览详情,提交后,返回已提交详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
detail_query DetailQuery 必须 详情查询对象
  • └ user_nick
  • String
  • 必须
  • xxx淘宝账号001
  • 机构淘宝账号昵称
  • └ item_id_list
  • Number []
  • 必须
  • [12321312, 2131231]
  • 拍品id列表(最多20个)
  • └ contains_detail
  • Boolean
  • 必须
  • true
  • 是否包含详细信息(不包含的话仅返回状态信息)

响应参数

名称 类型 示例值 描述
result_code String PACKAGE_EXPIRE 结果码
result_msg String 年框到期,请及时续期 结果信息描述
data DemandDetailVO [] 需求信息列表
  • └ has_submitted
  • Boolean
  • true
  • 是否已提交
  • └ user_can_submit
  • Boolean
  • true
  • 当前用户是否可以提交
  • └ protocol_contents
  • String []
  • 协议内容
  • demand_info
  • AcquisitionDemandInfo
  • 精准获客需求信息(未提交=预提交详情,提交=已提交内容详情)
  • └ acquisition_id
  • Number
  • 131231312
  • 获客需求id
  • └ acquisition_status
  • Number
  • 1
  • 获客需求状态, 1获客中,2获客结束,3获客成功
  • └ acquisition_status_desc
  • String
  • 获客中
  • 获客需求状态描述
  • └ service_type
  • Number
  • 1
  • 服务类型
  • └ service_type_desc
  • String
  • 精准获客服务标准包
  • 服务类型描述
  • └ service_time_type
  • Number
  • 1
  • 服务时间类型
  • └ service_time_type_desc
  • String
  • 单次
  • 服务时长描述
  • └ item_biz_type_desc
  • String
  • 普通资产
  • 资产类型描述
  • └ item_circle
  • String
  • 第一次
  • 拍卖周期描述
  • └ charge_rule_desc
  • String
  • 收费规则AA,适用于xxx
  • 收费规则描述
  • └ charge_amount_calc_desc
  • String
  • 全部收费齐全
  • 收费金额描述
  • └ deal_price
  • Number
  • 123123
  • 成交价
  • └ rate
  • String
  • 2.1
  • 费率
  • └ charge_value
  • Number
  • 321312
  • 收费值
  • └ contact_user
  • String
  • 小李
  • 联系人
  • └ contact_phone
  • String
  • 133xxxx3342
  • 联系电话
  • └ item_circle_id
  • Number
  • 2
  • 拍卖周期id
  • └ item_biz_type
  • Number
  • 1
  • 资产类型
  • item_info
  • ItemInfo
  • 拍品信息
  • └ item_id
  • Number
  • 1231231
  • 标的Id
  • └ item_title
  • String
  • xxxx
  • 标的标题
  • └ item_pic_url
  • String
  • xxx
  • 标的的图片链接
  • └ item_status
  • Number
  • 1
  • 标的状态
  • └ item_status_desc
  • String
  • 正在进行
  • 标的状态的描述
  • └ front_cat
  • Number
  • 1231213
  • 前台类目
  • └ front_cat_desc
  • String
  • 房产
  • 前台类目描述
  • └ item_location
  • String
  • 浙江省杭州市
  • 标的所在地
  • └ case_no
  • String
  • (20xx)鲁01民33x号
  • 标的案号
  • └ institution_name
  • String
  • xxx机构
  • 标的的处置方
  • └ start_price
  • Number
  • 2312311
  • 标的起拍价格
  • └ current_price
  • Number
  • 1231
  • 当前价
  • └ deal_price
  • Number
  • 1231
  • 成交价
  • └ auction_start_time
  • String
  • 2023-07-26 18:00:33
  • 竞拍开始时间
  • └ auction_end_time
  • String
  • 2023-07-28 18:00:33
  • 竞拍结束时间
  • └ deal_time
  • String
  • 2023-07-29 18:00:33
  • 标的成交时间
  • └ unit
  • String
  • 价格单位
  • └ item_circle
  • Number
  • 1
  • 处置阶段
  • pay_info
  • PayInfo
  • 支付信息
  • └ pay_status
  • Number
  • 0
  • 支付状态,0待支付,1已支付
  • └ user_can_pay
  • Boolean
  • true
  • 是否可支付
  • └ can_not_submit_reason
  • String
  • 很抱歉,您的标的属于全包项目,暂不支持精准获客服务!
  • 不可提交原因

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcJzhkDemandinfoBatchqueryRequest req = new AuctionZcJzhkDemandinfoBatchqueryRequest();
AuctionZcJzhkDemandinfoBatchqueryRequest.DetailQuery obj1 = new AuctionZcJzhkDemandinfoBatchqueryRequest.DetailQuery();
obj1.setUserNick("xxx淘宝账号001");
obj1.setItemIdList(new Long[] { 12321312, 2131231 };
);
obj1.setContainsDetail(true);
req.setDetailQuery(obj1);
AuctionZcJzhkDemandinfoBatchqueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<auction_zc_jzhk_demandinfo_batchquery_response>
    <result_code>PACKAGE_EXPIRE</result_code>
    <result_msg>年框到期,请及时续期</result_msg>
    <data>
        <demand_detail_v_o>
            <has_submitted>true</has_submitted>
            <user_can_submit>true</user_can_submit>
            <demand_info>
                <acquisition_id>131231312</acquisition_id>
                <acquisition_status>1</acquisition_status>
                <acquisition_status_desc>获客中</acquisition_status_desc>
                <service_type>1</service_type>
                <service_type_desc>精准获客服务标准包</service_type_desc>
                <service_time_type>1</service_time_type>
                <service_time_type_desc>单次</service_time_type_desc>
                <item_biz_type_desc>普通资产</item_biz_type_desc>
                <item_circle>第一次</item_circle>
                <charge_rule_desc>收费规则AA,适用于xxx</charge_rule_desc>
                <charge_amount_calc_desc>全部收费齐全</charge_amount_calc_desc>
                <deal_price>123123</deal_price>
                <rate>2.1</rate>
                <charge_value>321312</charge_value>
                <contact_user>小李</contact_user>
                <contact_phone>133xxxx3342</contact_phone>
                <item_circle_id>2</item_circle_id>
                <item_biz_type>1</item_biz_type>
            </demand_info>
            <item_info>
                <item_id>1231231</item_id>
                <item_title>xxxx</item_title>
                <item_pic_url>xxx</item_pic_url>
                <item_status>1</item_status>
                <item_status_desc>正在进行</item_status_desc>
                <front_cat>1231213</front_cat>
                <front_cat_desc>房产</front_cat_desc>
                <item_location>浙江省杭州市</item_location>
                <case_no>(20xx)鲁01民33x号</case_no>
                <institution_name>xxx机构</institution_name>
                <start_price>2312311</start_price>
                <current_price>1231</current_price>
                <deal_price>1231</deal_price>
                <auction_start_time>2023-07-26 18:00:33</auction_start_time>
                <auction_end_time>2023-07-28 18:00:33</auction_end_time>
                <deal_time>2023-07-29 18:00:33</deal_time>
                <unit>元</unit>
                <item_circle>1</item_circle>
            </item_info>
            <pay_info>
                <pay_status>0</pay_status>
                <user_can_pay>true</user_can_pay>
            </pay_info>
            <can_not_submit_reason>很抱歉,您的标的属于全包项目,暂不支持精准获客服务!</can_not_submit_reason>
        </demand_detail_v_o>
    </data>
</auction_zc_jzhk_demandinfo_batchquery_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

返回
顶部