API文档 经营风险 外部黑名单
基本信息
接口地址
https://api.qixin.com/APIService/enterprise/getEntBlacklistByKeyword
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/enterprise/getEntBlacklistByKeyword?keyword=湖南省雄大西南建筑园林有限公司
描述
通过企业名称获取多源企业黑名单负面信息
请求参数 (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)
参数名类型必填描述
keyword String 企业全名/注册号/统一社会信用代码
skip Number 跳过条目数(默认为0,单页返回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 数据列表
name
data.data.items.name
String 255 企业名称
eid
data.data.items.eid
String 36 企业id
department_level
data.data.items.department_level
String 255 认定部门等级,枚举值为:国家级 、省级、市级、县级、乡级、其他
lists_type
data.data.items.lists_type
String 255 黑名单类型,01政府黑名单 02环保失信黑名单 03应急管理部安全生产失信黑名单 04政府采购黑名单 05“屡禁不止、屡罚不改”黑名单 06 其他 07 假冒国企名单 08 军队采购失信名单 09 政府采购失信名单 10 供应商暂停名单 11 社会组织活动异常名录 12 社会组织严重违法失信名单 13 涉金融领域黑名单 14 价格招采信用评价失信名单 15拖欠农民工工资失信联合惩戒对象16 交通运输行业黑名单 17 军队采购预警黑名单
black_basis
data.data.items.black_basis
String 255 黑名单认定依据
maintain_department
data.data.items.maintain_department
String 255 认定部门
credit_no
data.data.items.credit_no
String 255 统一社会信用代码
in_lists_date
data.data.items.in_lists_date
String 255 列入黑名单日期,排序字段
out_lists_date
data.data.items.out_lists_date
String 255 移出黑名单日期
punishment_result
data.data.items.punishment_result
String 225 处罚结果
details
data.data.items.details
String 255 失信情形
is_history
data.data.items.is_history
String 10 是否历史
num
data.data.num
Number 10 当前返回列表的总条数
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "76e72621113df5d63f0510f7b41ef253",
    "data": {
        "num": 1,
        "total": 1,
        "items": [
            {
                "name": "xxxxx园林有限公司",
                "eid": "2bc1baa7-8fd8-40a8-a641-af1b2dea8929",
                "department_level": "省级",
                "lists_type": "应急管理部安全生产失信黑名单",
                "black_basis": "存在严重违法违规行为,发生重特大生产安全责任事故。符合《国家安全监管总局关于印发<对安全生产领域失信行为开展联合惩戒的实施办法>的通知》(安监总办〔2017〕49号)规定情形。",
                "maintain_department": "湖南省安全生产监督管理局",
                "credit_no": "91431000582753597N",
                "in_lists_date": "2017-06-20",
                "out_lists_date": "-",
                "is_history": "0",
                "details": "-",
                "punishment_result": "-"
            }
        ]
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/enterprise/getEntBlacklistByKeyword';
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 = {
    keyword: 'keyword的值',
    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);
});