对外担保 - API文档

基本信息

接口地址

https://api.qixin.com/APIService/qc/getGuaranteeList

数据格式

JSON

请求方式

GET

请求示例

https://api.qixin.com/APIService/qc/getGuaranteeList?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	返回查询结果，如果没有匹配记录则返回为空。具体字段含义见下表
`total` data.data.total	Number	0	返回列表中记录总数
`items` data.data.items	Array	0	企业员工信息列表
`guarstartdate` data.data.items.guarstartdate	String	255	担保起始日期
`securityname` data.data.items.securityname	String	255	信息披露方_名称
`eid` data.data.items.eid	String	255	信息披露方eid
`buarrelation` data.data.items.buarrelation	String	400	被担保方_与披露方关系
`guareid` data.data.items.guareid	String	36	担保方eid
`id` data.data.items.id	String	20	id
`guarjine` data.data.items.guarjine	String	50	担保金额
`reportdate` data.data.items.reportdate	String	255	报告期
`tradedate` data.data.items.tradedate	String	255	交易日期
`noticedate` data.data.items.noticedate	String	255	公告日期
`isrltrade` data.data.items.isrltrade	String	40	是否关联交易，0 否，1 是
`guarenddate` data.data.items.guarenddate	String	255	担保终止日期
`guarrelation` data.data.items.guarrelation	String	400	担保方_与披露方关系
`reporttype` data.data.items.reporttype	String	40	报告期类别：1年报；2中报；3一季度报告；4三季度报告；5临时公告; 6申报稿; 7说明书; 8意向书; 9公告书
`buareid` data.data.items.buareid	String	36	被担保方eid
`guarmethod` data.data.items.guarmethod	String	200	担保方式
`isperform` data.data.items.isperform	String	40	是否履行完毕；0 否，1 是
`warcontent` data.data.items.warcontent	String	6000	担保事件说明
`guardealine` data.data.items.guardealine	String	50	担保期限(年)
`currency` data.data.items.currency	String	80	币种
`guarcomname` data.data.items.guarcomname	String	200	担保方_公司名称
`buarcomname` data.data.items.buarcomname	String	200	被担保方_公司名称
`sign` data.sign	String	32	数据签名
`status` data.status	String	10	返回结果状态
`message` data.message	String	255	返回结果消息

响应示例

JSON

{
    "status": "200",
    "message": "操作成功",
    "sign": "7fa7ed0269314fd993b18041c13e6ada",
    "data": {
        "total": 78,
        "items": [
            {
                "id": "1122464",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-12-06",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "1000",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1122465",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-12-20",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "3000",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1122466",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-07-05",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "2000",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1122467",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-10-25",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "3000",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1122468",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-12-06",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "1000",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1122469",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-08-09",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "2000",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1122470",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-08-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2022-11-02",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "5900",
                "reportdate": "2024-06-30",
                "reporttype": "2",
                "isperform": "0",
                "guarmethod": "抵押担保,连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1069029",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-04-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2022-11-02",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "5900",
                "reportdate": "2023-12-31",
                "reporttype": "1",
                "isperform": "0",
                "guarmethod": "保证担保,抵押担保,连带责任担保",
                "isrltrade": "0"
            },
            {
                "id": "1069030",
                "eid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "securityname": "好利科技",
                "noticedate": "2024-04-29",
                "guarcomname": "好利来（中国）电子科技股份有限公司",
                "guareid": "b6cabefc-6b30-481b-a0cc-068764b742d3",
                "guarrelation": "公司本身",
                "buarcomname": "好利来（厦门）电路保护科技有限公司",
                "buareid": "23d43de2-8b79-416f-a444-8df7c2357156",
                "buarrelation": "全资子公司",
                "tradedate": "2023-08-09",
                "guardealine": "-",
                "currency": "CNY",
                "guarstartdate": "",
                "guarenddate": "",
                "warcontent": "-",
                "guarjine": "2000",
                "reportdate": "2023-12-31",
                "reporttype": "1",
                "isperform": "0",
                "guarmethod": "保证担保,连带责任担保",
                "isrltrade": "0"
            }
        ]
    }
}

代码示例

javascript

let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

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

java

import com.mashape.unirest.http.*;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.security.MessageDigest;
import java.util.Calendar;
import java.net.URLEncoder;

public class main {
    // 获取字符串的md5值
    public static String getMD5Str(String str) {
        byte[] digest = null;
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            md.update(str.getBytes(StandardCharsets.UTF_8));
            digest = md.digest();

            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                String s = String.format("%02x", b);
                sb.append(s);
            }
            return sb.toString();
        } catch (Exception e) {
            e.printStackTrace();
        }

        return null;
    }

    public static void main(String[] args) throws Exception {
        String baseUrl = "https://api.qixin.com/APIService/qc/getGuaranteeList";
        String appkey = "正式appkey";
        String secretKey = "正式secret_key";
        Calendar calendar = Calendar.getInstance();
        Long timestamp = calendar.getTime().getTime();
        String sign = getMD5Str(appkey + timestamp + secretKey);

        // 设置url参数
        Map<String, String> urlParams = new HashMap<String, String>();
        urlParams.put("name", "name的值");
        urlParams.put("skip", "skip的值");

        List<String> concatParams = new ArrayList<String>();
        for (String s : urlParams.keySet()) {
            concatParams.add(s + "=" + URLEncoder.encode(urlParams.get(s), StandardCharsets.UTF_8));
        }

        Unirest.setTimeouts(0, 2000);
        try {
            // 发送get请求，得到响应
            HttpResponse<String> response = Unirest.get(baseUrl + "?" + String.join("&", concatParams))
                    .header("Auth-version", "2.0")
                    .header("appkey", appkey)
                    .header("timestamp", timestamp + "")
                    .header("sign", sign)
                    .header("Content-Type", "application/json")
                    .asString();

            System.out.println(response.getBody());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

csharp

using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Text;
using System.Text.Encodings.Web;
using System.Security.Cryptography;

namespace csharp
{
    class Program
    {
        public static string GetMD5Str(string str)
        {
            MD5 md5 = MD5.Create();
            byte[] buffer = Encoding.Default.GetBytes(str);
            byte[] MD5Buffer = md5.ComputeHash(buffer);

            //将字节数组转换成字符串
            string strResult = "";
            for (int i = 0; i < MD5Buffer.Length; i++)
            {
                strResult += MD5Buffer[i].ToString("x2");
            }

            return strResult;
        }

        static void Main(string[] args)
        {
            var baseUrl = "https://api.qixin.com/APIService/qc/getGuaranteeList";
            var appkey = "正式appkey";
            var secretKey = "正式secret_key";
            TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
            var timeStamp = Convert.ToInt64(ts.TotalMilliseconds).ToString();  // 当前utc时间戳
            var sign = GetMD5Str(appkey + timeStamp + secretKey);              // 请求签名  

            // 设置url参数
            Dictionary<string, string> urlParams = new Dictionary<string, string>();
            urlParams.Add("name", "name的值");,
    urlParams.Add("skip", "skip的值");

            UrlEncoder ins = UrlEncoder.Create();
            List<string> concatParams = new List<string>();
            foreach (KeyValuePair<string, string> param in urlParams)
            {
                concatParams.Add(param.Key + "=" + ins.Encode(param.Value));
            }

            // 发送GET请求
            HttpClient httpClient = new HttpClient();
            httpClient.DefaultRequestHeaders.Add("Auth-version", "2.0");
            httpClient.DefaultRequestHeaders.Add("appkey", appkey);
            httpClient.DefaultRequestHeaders.Add("timestamp", timeStamp);
            httpClient.DefaultRequestHeaders.Add("sign", sign);
            httpClient.DefaultRequestHeaders.Add("Connection", "keep-alive");
            var urlWithParams = baseUrl + "?" + string.Join("&", concatParams.ToArray());
            var get = httpClient.GetAsync(urlWithParams);

            // 输出响应
            Console.WriteLine(get.Result.Content.ReadAsStringAsync().Result);
        }
    }
}

python

# -*- coding:utf-8 -*-

import requests
import json
import time
import hashlib
from urllib.parse import urlencode


def md5Encode(srcStr):
    '''计算字符串的md5值'''
    m = hashlib.md5()
    m.update(srcStr.encode('utf-8'))
    return m.hexdigest()


# 接口信息
baseUrl = 'https://api.qixin.com/APIService/qc/getGuaranteeList'
appkey = '正式appkey'
secretKey = '正式secret_key'
timeStamp = int(time.time()) * 1000

# 设置请求头部信息
headers = {
    'Auth-version': '2.0',              # 指定接口验证版本
    'appkey': appkey,
    'timestamp': str(timeStamp),
    'sign': md5Encode(appkey + str(timeStamp) + secretKey),
    'Connection': 'keep-alive'
}

# 请求参数
urlParams = {
    'name': 'name的值',
    'skip': 'skip的值'
}

# 构造url
url = '{}?{}'.format(baseUrl, urlencode(urlParams))
print(url)

# 调用接口
response = requests.get(url, headers=headers)

# 处理响应数据
jsonContent = json.dumps(str(response.content, encoding='utf-8'))
rspResult = jsonContent.encode('utf-8').decode('unicode-escape')
print(rspResult)

文档下载

68.11-对外担保.pdf

PDF接口文档

证券信息 - 相关接口

股票信息 43.3 上市公司概况 68.1 股东人数 68.2 十大股东 68.3 十大流通股东 68.4 上市公司高管 68.5 股本结构 68.6 股本变动 68.7 十大股东持股变动 68.8 上市公司公告 68.9 上市公司员工构成 68.10 对外担保 68.11 违规处理 68.12 分红情况 68.13 增发情况 68.14 配股情况 68.15 财务主要指标 68.17 现金流量表 68.20 利润表 68.18 资产负债表 68.19