一、接口名称

招投标列表查询接口

二、接口介绍

招投标列表查询接口，可通过企业名称、注册号、统一信用代码任一项查询招投标信息，查询信息包括招投标主键、标题、发布时间、所属地区、项目分类等，以列表形式返回。

三、API接口文档

1. 

请求地址url：https://api.shumaidata.com/v4/bids/query

请求方式 method：get/post

参数：

2. 签名算法说明

服务商分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。

 如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc ;

 拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;

 加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;

3. 正确返回示例

{

    "msg": "成功",

    "success": true,

    "code": 200,

    "data": {

        "orderNo": "958350174430964285",

        "total": 296,

        "items": [

            {

                "publishDate": "2024-09-05 00:00:00",

                "id": 110730530,

                "provinceName": "HB",

                "channelName": "招标结果",

                "title": "国家能源集团雄安基地项目主体工程施工总承包（二次）中标候选人公示"

            }

        ]

    }

}

4. 错误返回示例

{

    "msg": "入参错误",

    "success": false,

    "code": 400,

    "data": { }

}

5. 返回字段说明

6. Code错误码说明

四、相关接口推荐

全国招投标信息查询接口：覆盖全国各地区每天更新海量招投标信息，提供项目招标、采购、招商等数据信息服务，并及时更新海量的招标采购项目信息，提供建设项目追踪和行业数据分析服务，适用于企业单位招投标参考工具。

招投标信息垂搜接口：通过关键词（标题，采购人，供应商、省份、信息类型等)查询招投标信息，可查询返回招投标企业、招标公告、招标代理公司等招投标信息。

更多API接口调用：https://www.shumaiapi.com/product