淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
itemid	Number	可选	1234567	标的 ID
apply_id	Number	可选	12345678	资质审核 ID
seller_nick	String	必须	xxx法院	卖家 NICK
buyer_nick	String	可选	小蓝	买家 NICK
status	Number	可选	1	审核状态（1:待审核，2:审核通过，3:审核不通过，4:审核过期）
page_no	Number	必须	1	页数（从1开始每页默认10条）

名称	类型	示例值	描述
apply_list	QualApplyVo []	资质审核列表	资质审核列表
└ apply_id Number 12345689 资质审核 ID └ auction_title String 桑塔纳一辆标的标题 └ main_pic String hfJILdj324sf 主图URL └ auction_start Date 2019.11.28 15:39:53 开拍时间 └ auction_end Date 2019.11.28 15:39:53 结束时间 └ item_status Number 1 标的状态（0未出价，1出价中，2已生成订单，3失败，4失效） └ qual_apply_end_date Date 2019.11.28 15:39:53 资质审核截止时间 └ qual_status Number 1 资质审核状态（1 等待审核,2 审核通过,3 审核不通过,4 审核已过期） └ audit_result String 身份不匹配审核备注（原因） └ submit_time Date 2019.11.28 15:39:53 提交时间 └ audit_time Date 2019.11.28 15:39:53 审核时间 attachment_list QualAttachFile [] 附件列表附件列表 └ download_url String hjkhf67GGHF 附件URL └ title String 图片A.jpg 附件名称 └ pics_list String [] 图片列表图片列表，临时url，有效期一小时 buyer_info QualUserInfo 买家信息买家信息 └ phone String 12345678901 手机号 └ realname String 王xx 用户姓名 └ card_number String 12345678901 证件号 └ card_type Number 2 证件类型：1=企业营业执照,2=身份证,3=台胞证,4=港澳证件,5=护照,8=组织机构代码证件,9=统一社会信用代码 └ buyer_open_id String AAEuzpioAMVwNvnMvUs6Q2Qj 买家openId，该字段竞拍期间为空，标的结束后有值 privilege_info_list QualUserInfo [] 委托人列表委托人列表 └ phone String 12345678901 手机号 └ realname String 王xx 用户姓名 └ card_number String 12345678901 证件号 └ card_type Number 2 证件类型：1=企业营业执照,2=身份证,3=台胞证,4=港澳证件,5=护照,8=组织机构代码证件,9=统一社会信用代码 └ item_id Number 12345678 标的 ID └ buyer_economic_type Number 1 受让方经济类型，0:个人 1:国资监管机构/政府部门 2:国有独资企业（公司）/国有全资企业 3:国有控股企业 4:国有事业单位，国有社团等 5:国有实际控制企业 6:国有参股企业 7:非国有企业 8:外资企业 9:其他 custom_attachment_list CustomQualAttachmentVO [] 自定义资质报名资料内容 └ out_id String out_id_123 资料外部系统id └ name String 身份证正反面扫描件资料名称 └ type Number 1 资料类型 1 图片 2 附件 └ buyer_preview_url String //zc-paimai.daily.taobao.net/download_attach.do?attach_id=123 买家提交的资料预览/下载url └ buyer_preview_title String 勘探确认书.pdf 买家提交的资料的标题，图片名或者附件名
total_item	Number	30	当前查询条件记录总数

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionGovQualificationListRequest req = new AuctionGovQualificationListRequest();
req.setItemid(1234567L);
req.setApplyId(12345678L);
req.setSellerNick("xxx法院");
req.setBuyerNick("小蓝");
req.setStatus(1L);
req.setPageNo(1L);
AuctionGovQualificationListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<auction_gov_qualification_list_response>
    <apply_list>
        <qual_apply_vo>
            <apply_id>12345689</apply_id>
            <auction_title>桑塔纳一辆</auction_title>
            <main_pic>hfJILdj324sf</main_pic>
            <auction_start>2019.11.28 15:39:53</auction_start>
            <auction_end>2019.11.28 15:39:53</auction_end>
            <item_status>1</item_status>
            <qual_apply_end_date>2019.11.28 15:39:53</qual_apply_end_date>
            <qual_status>1</qual_status>
            <audit_result>身份不匹配</audit_result>
            <submit_time>2019.11.28 15:39:53</submit_time>
            <audit_time>2019.11.28 15:39:53</audit_time>
            <attachment_list>
                <qual_attach_file>
                    <download_url>hjkhf67GGHF</download_url>
                    <title>图片A.jpg</title>
                </qual_attach_file>
            </attachment_list>
            <pics_list>
                <string>图片列表</string>
            </pics_list>
            <buyer_info>
                <phone>12345678901</phone>
                <realname>王xx</realname>
                <card_number>12345678901</card_number>
                <card_type>2</card_type>
                <buyer_open_id>AAEuzpioAMVwNvnMvUs6Q2Qj</buyer_open_id>
            </buyer_info>
            <privilege_info_list>
                <qual_user_info>
                    <phone>12345678901</phone>
                    <realname>王xx</realname>
                    <card_number>12345678901</card_number>
                    <card_type>2</card_type>
                </qual_user_info>
            </privilege_info_list>
            <item_id>12345678</item_id>
            <buyer_economic_type>1</buyer_economic_type>
            <custom_attachment_list>
                <custom_qual_attachment_v_o>
                    <out_id>out_id_123</out_id>
                    <name>身份证正反面扫描件</name>
                    <type>1</type>
                    <buyer_preview_url>//zc-paimai.daily.taobao.net/download_attach.do?attach_id=123</buyer_preview_url>
                    <buyer_preview_title>勘探确认书.pdf</buyer_preview_title>
                </custom_qual_attachment_v_o>
            </custom_attachment_list>
        </qual_apply_vo>
    </apply_list>
    <total_item>30</total_item>
</auction_gov_qualification_list_response>

{
    "auction_gov_qualification_list_response":{
        "apply_list":{
            "qual_apply_vo":[
                {
                    "apply_id":12345689,
                    "auction_title":"桑塔纳一辆",
                    "main_pic":"hfJILdj324sf",
                    "auction_start":"2019.11.28 15:39:53",
                    "auction_end":"2019.11.28 15:39:53",
                    "item_status":1,
                    "qual_apply_end_date":"2019.11.28 15:39:53",
                    "qual_status":1,
                    "audit_result":"身份不匹配",
                    "submit_time":"2019.11.28 15:39:53",
                    "audit_time":"2019.11.28 15:39:53",
                    "attachment_list":{
                        "qual_attach_file":[
                            {
                                "download_url":"hjkhf67GGHF",
                                "title":"图片A.jpg"
                            }
                        ]
                    },
                    "pics_list":{
                        "string":[
                            "图片列表"
                        ]
                    },
                    "buyer_info":{
                        "phone":"12345678901",
                        "realname":"王xx",
                        "card_number":"12345678901",
                        "card_type":2,
                        "buyer_open_id":"AAEuzpioAMVwNvnMvUs6Q2Qj"
                    },
                    "privilege_info_list":{
                        "qual_user_info":[
                            {
                                "phone":"12345678901",
                                "realname":"王xx",
                                "card_number":"12345678901",
                                "card_type":2
                            }
                        ]
                    },
                    "item_id":12345678,
                    "buyer_economic_type":1,
                    "custom_attachment_list":{
                        "custom_qual_attachment_v_o":[
                            {
                                "out_id":"out_id_123",
                                "name":"身份证正反面扫描件",
                                "type":1,
                                "buyer_preview_url":"\/\/zc-paimai.daily.taobao.net\/download_attach.do?attach_id=123",
                                "buyer_preview_title":"勘探确认书.pdf"
                            }
                        ]
                    }
                }
            ]
        },
        "total_item":30
    }
}

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测试工具错误码查询工具 SDK下载

开放平台

拍卖API

taobao.auction.gov.qualification.list (分页查询资质审核提交列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ