API文档 地产建筑 建设工程规划许可证
基本信息
接口地址
https://api.qixin.com/APIService/realestate/getPlanEngineerLicenseListByName
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/realestate/getPlanEngineerLicenseListByName?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,以此类推进行取数)
响应参数
参数名类型长度描述
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
sign
data.sign
String 32 数据签名
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表
total
data.data.total
Number 10 返回列表中记录总数
items
data.data.items
Array 0 数据列表
id
data.data.items.id
String 36
eid
data.data.items.eid
String 255 建设单位 ID
buildingUnit
data.data.items.buildingUnit
String 255 建设单位
registerNo
data.data.items.registerNo
String 255 证书编号
projectName
data.data.items.projectName
String 255 项目名称
buildingLocation
data.data.items.buildingLocation
String 255 建设位置
buildingScope
data.data.items.buildingScope
String 255 建设规模
issueDate
data.data.items.issueDate
String 255 核发日期
licensePhoto
data.data.items.licensePhoto
String 255 建设工程规划许可证快照
num
data.data.num
Number 10 当前返回列表的总条数
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "a28609cb9d1fa000fc40148bab9ed860",
    "data": {
        "total": 7,
        "num": 7,
        "items": [
            {
                "id": "18003",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2016规(西)建字0086号",
                "projectName": "西城区综合养老服务中心建设工程(西城区综合养老服务中心建设工程)",
                "buildingLocation": "西城区广安门外红莲北里10号",
                "buildingScope": "17919.62平方米",
                "issueDate": "2016-11-08",
                "licensePhoto": "http:\/\/qxb-img.oss-cn-hangzhou.aliyuncs.com\/longfor\/18b8c5e251751ca06a4d5620fbab87b0.jpg"
            },
            {
                "id": "19936",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2015规(西)建字0053号",
                "projectName": "西城区金融街社区卫生服务中心综合配套用房(西城区金融街社区卫生服务中心综合配套用房)",
                "buildingLocation": "西城区阜成门内大街290-296号",
                "buildingScope": "505.6平方米",
                "issueDate": "2015-07-20",
                "licensePhoto": "http:\/\/qxb-img.oss-cn-hangzhou.aliyuncs.com\/longfor\/1ba2466aecf51bc1da7a378488abf60f.jpg"
            },
            {
                "id": "33575",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2009规(西)建字0193号",
                "projectName": "1号楼外立面装修(东段)等2项",
                "buildingLocation": "西城区二龙路27号(金融街街道)",
                "buildingScope": "-",
                "issueDate": "2009-08-27",
                "licensePhoto": "-"
            },
            {
                "id": "34031",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2009规(西)建字0146号",
                "projectName": "西城区机关事务服务中心附属用房加层",
                "buildingLocation": "西城区二龙路西街5号(金融街街道)",
                "buildingScope": "-",
                "issueDate": "2009-06-30",
                "licensePhoto": "-"
            },
            {
                "id": "35832",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2008规(西)建字0160号",
                "projectName": "金融街社区卫生服务中心",
                "buildingLocation": "西城区阜内大街290-296号(金融街街道)",
                "buildingScope": "-",
                "issueDate": "2008-10-30",
                "licensePhoto": "-"
            },
            {
                "id": "42450",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2006规(西)建字0236号",
                "projectName": "改建办公楼",
                "buildingLocation": "西城区二龙路27号",
                "buildingScope": "-",
                "issueDate": "2006-12-31",
                "licensePhoto": "-"
            },
            {
                "id": "49762",
                "eid": "7396b4c4-865c-11e8-9306-00163e0ca5c5",
                "buildingUnit": "北京市西城区机关事务服务中心",
                "registerNo": "2005规(西)建字0161号",
                "projectName": "添建办公用房等2项",
                "buildingLocation": "西城区国英园4号楼",
                "buildingScope": "-",
                "issueDate": "2005-07-22",
                "licensePhoto": "-"
            }
        ]
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/realestate/getPlanEngineerLicenseListByName';
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);
});