API文档 地产建筑 工程竣工验收信息
基本信息
接口地址
https://api.qixin.com/APIService/realestate/getEngineerCompleteCheckListByName
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/realestate/getEngineerCompleteCheckListByName?name=北京市西城区机关事务服务中心
描述
工程竣工验收信息,包括建设单位、项目名称、施工单位、备案部门、竣工备案日期等
请求参数 (Headers)
参数名类型必填描述
Auth-Version String 2.0(参数值),固定传入:2.0
appkey String 启信慧眼数据开放平台获取 ,获取方式:个人中心-安全中心-API 密钥,获取appkey的同时,请完成IP白名单的配置:个人中心-安全中心-API IP白名单设置,如未配置,接口调试会报错“104 未添加IP白名单”
timestamp String UNIX时间戳,精确到毫秒,示例:1656921036000,当前系统时间近10分钟有效
sign String 请求认证签名,对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果,小写字符串(实际加密不带入‘+’)
请求参数 (Query)
参数名类型必填描述
name String 企业全名/注册号/统一社会信用代码
skip Number 跳过条目数(跳过的条数,默认不填返回前20条,取21到40条的数据,skip=20,以此类推进行取数)
响应参数
参数名类型长度描述
data
data.data
Object 0 返回查询结果,每次调用返回20条记录,如果没有匹配记录则返回为空。具体字段含义见下表
total
data.data.total
Number 0 返回列表中记录总数
num
data.data.num
Number 0 本次调用返回记录数
items
data.data.items
Array 0 竣工工程信息列表
completeDate
data.data.items.completeDate
String 255 竣工备案日期
filingDepartment
data.data.items.filingDepartment
String 255 备案部门
eid
data.data.items.eid
String 36 建设单位ID
id
data.data.items.id
String 36
constructionUnit
data.data.items.constructionUnit
String 255 施工单位
projectName
data.data.items.projectName
String 255 项目名称
number
data.data.items.number
String 255 编号
buildingUnit
data.data.items.buildingUnit
String 255 建设单位
sign
data.sign
String 32 数据签名
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "11d8043fd12fd5507c6b6262a9f6d275",
    "data": {
        "total": 10,
        "num": 10,
        "items": [
            {
                "id": "109778",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0435西竣2021(装)0060号",
                "projectName": "西城区博兴胡同8号装修改造工程",
                "constructionUnit": "中集建设集团有限公司",
                "filingDepartment": "北京市西城区住房和城市建设委员会",
                "completeDate": "2021-07-14"
            },
            {
                "id": "97596",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0129西竣2020(装)0010号",
                "projectName": "西城区山西街6号院2号楼103、203、205及206号装修工程",
                "constructionUnit": "北京城建远东建设投资集团有限公司",
                "filingDepartment": "北京市西城区住房和城市建设委员会",
                "completeDate": "2020-04-23"
            },
            {
                "id": "23",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0477西竣2019(建)0026号",
                "projectName": "西城区综合养老服务中心建设工程(西城区综合养老服务中心建设工程)",
                "constructionUnit": "中煤建设集团工程有限公司",
                "filingDepartment": "北京市西城区住房和城市建设委员会",
                "completeDate": "2019-10-02"
            },
            {
                "id": "5030",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0085西竣2017(装)0022号",
                "projectName": "西城区广安门外小红庙11号装修改造工程",
                "constructionUnit": "北京建工博海建设有限公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2017-05-16"
            },
            {
                "id": "5722",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0158西竣2015(装)0025号",
                "projectName": "牛街20号装修工程",
                "constructionUnit": "北京爱地鑫装饰艺术有限责任公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2015-09-02"
            },
            {
                "id": "10993",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0095西竣2014(装)0019号",
                "projectName": "广安门外西豪逸景6号楼刑警办公楼装修改造项目",
                "constructionUnit": "北京城建亚泰建设集团有限公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2014-07-01"
            },
            {
                "id": "7862",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0020西竣2014(装)0008号",
                "projectName": "西城区冠英园西区五号楼装饰改造工程",
                "constructionUnit": "北京中建华通建设发展有限公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2014-02-07"
            },
            {
                "id": "6745",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0128西竣2012(装)0068号",
                "projectName": "西城区新街口社区卫生服务中心装修改造工程",
                "constructionUnit": "南通启益建设集团有限公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2012-11-02"
            },
            {
                "id": "5460",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0125西竣2012(装)0062号",
                "projectName": "北京市西城区综合行政服务中心装修改造工程",
                "constructionUnit": "北京市凯伯特装饰工程有限公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2012-10-19"
            },
            {
                "id": "4038",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "number": "0104西竣2012(装)0047号",
                "projectName": "西城区社区服务中心装修改造工程",
                "constructionUnit": "北京市凯伯特装饰工程有限公司",
                "filingDepartment": "西城区住房城市建设委",
                "completeDate": "2012-09-03"
            }
        ]
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/realestate/getEngineerCompleteCheckListByName';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');

let urlParams = {
    name: 'name的值',
    skip: 'skip的值'
}

let concatParams = []
for (let key in urlParams) {
    concatParams.push(key + '=' + urlParams[key]);
}

let options = {
    'method': 'GET',
    'url': baseUrl + '?' + concatParams.join('&'),
    'headers': {
        'Connection': 'keep-alive',
        'Auth-version': '2.0',
        'appkey': appkey,
        'timestamp': timeStamp,
        'sign': sign
    }
};

request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});