API文档 关联关系 三层族谱
基本信息
接口地址
https://api.qixin.com/APIService/relation/getRelationInfoByName
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/relation/getRelationInfoByName?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 企业全名/注册号/统一社会信用代码
响应参数
参数名类型长度描述
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回为空。具体字段含义见下表
p_trees
data.data.p_trees
Array 0 股东族谱
eid
data.data.p_trees.eid
String 36 企业id,只有工商注册的企业不为空,其它都为空
name
data.data.p_trees.name
String 255 姓名
type
data.data.p_trees.type
String 255 类型,“E”表示企业,“P”表示个人,UE-未在工商注册的企业 U-类似社会公众股、自然人股东、法人股等字段
has_problem
data.data.p_trees.has_problem
String 255 是否有失信记录,“0”表示没有,“1”表示有
short_name
data.data.p_trees.short_name
String 255 姓名
amount
data.data.p_trees.amount
String 255 投资金额(万元)
percent
data.data.p_trees.percent
String 255 占股比
sh_type
data.data.p_trees.sh_type
String 255 股东类型
level
data.data.p_trees.level
String 255 股东层级
identifier
data.data.p_trees.identifier
String 255 节点唯一标识,用于构图
items
data.data.p_trees.items
Array 0 当前结点的股东族谱,子节点结构与父节点相同,包含字段eid,name,type,has_problem,short_name,identifier,items
c_count
data.data.c_count
Number 10 对外投资族谱的子节点个数
p_count
data.data.p_count
Number 10 股东族谱的子节点个数
name
data.data.name
String 255 名称
has_problem
data.data.has_problem
String 255 是否有失信记录,“0”表示没有,“1”表示有
eid
data.data.eid
String 36 企业id,只有工商注册的企业不为空,其它都为空
c_trees
data.data.c_trees
Array 0 对外投资族谱
eid
data.data.c_trees.eid
String 36 企业id,只有工商注册的企业不为空,其它都为空
name
data.data.c_trees.name
String 255 名称
type
data.data.c_trees.type
String 255 类型,“E”表示企业,“P”表示个人,UE-未在工商注册的企业 U-类似社会公众股、自然人股东、法人股等字段
has_problem
data.data.c_trees.has_problem
String 255 是否有失信记录,“0”表示没有,“1”表示有
short_name
data.data.c_trees.short_name
String 255 名称简称
amount
data.data.c_trees.amount
String 255 投资金额(万元)
percent
data.data.c_trees.percent
String 255 占股比
sh_type
data.data.c_trees.sh_type
String 255 股东类型
level
data.data.c_trees.level
String 255 股东层级
identifier
data.data.c_trees.identifier
String 255 节点唯一标识,用于构图
items
data.data.c_trees.items
Array 0 当前结点的对外投资族谱,子节点结构与父节点相同,包含字段eid,name,type,has_problem,short_name,identifier,items
identifier
data.data.identifier
String 255 节点唯一标识,用于构图
type
data.data.type
String 255 类型,“E”表示企业,“P”表示个人,UE-未在工商注册的企业U-类似社会公众股、自然人股东、法人股等字段
short_name
data.data.short_name
String 255 名称简称
sign
data.sign
String 32 数据签名
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "26381b2c47927ac62622c231d4fb897c",
    "data": {
        "eid": "2c1ae58d-6772-41e0-854e-855b9f77efae",
        "name": "成都成电光信科技股份有限公司",
        "type": "E",
        "has_problem": "0",
        "short_name": "成电光信科技",
        "identifier": "1",
        "p_trees": [
            {
                "eid": "null",
                "name": "邱昆",
                "type": "P",
                "has_problem": "0",
                "short_name": "邱昆",
                "amount": "994.04shares",
                "percent": "0.1907",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "2",
                "items": []
            },
            {
                "eid": "null",
                "name": "解军",
                "type": "P",
                "has_problem": "0",
                "short_name": "解军",
                "amount": "660.06shares",
                "percent": "0.1267",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "3",
                "items": []
            },
            {
                "eid": "null",
                "name": "鲍永明",
                "type": "P",
                "has_problem": "0",
                "short_name": "鲍永明",
                "amount": "530.0shares",
                "percent": "0.1017",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "4",
                "items": []
            },
            {
                "eid": "null",
                "name": "付美",
                "type": "P",
                "has_problem": "0",
                "short_name": "付美",
                "amount": "500.8149shares",
                "percent": "0.0961",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "5",
                "items": []
            },
            {
                "eid": "7407ca36-b4f0-4409-8668-8c597c6aff99",
                "name": "成都隼睿投资合伙企业(有限合伙)",
                "type": "E",
                "has_problem": "0",
                "short_name": "隼睿投资",
                "amount": "429.0shares",
                "percent": "0.0823",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "6",
                "items": [
                    {
                        "eid": "57782787-4f89-4858-8a5c-da5612ce4c35",
                        "name": "四川信托有限公司",
                        "type": "E",
                        "has_problem": "0",
                        "short_name": "四川信托有限公司",
                        "amount": "4150.0",
                        "percent": "0.9975961538",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "7",
                        "items": [
                            {
                                "eid": "46c897da-896f-432c-90e4-d5f5d1c89832",
                                "name": "四川宏达(集团)有限公司",
                                "type": "E",
                                "has_problem": "1",
                                "short_name": "宏达",
                                "amount": "112135.700743",
                                "percent": "0.3203877164",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "8",
                                "items": []
                            },
                            {
                                "eid": "f223d195-3af1-47cc-ac17-4165c3721e7c",
                                "name": "中海信托股份有限公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "中海信托",
                                "amount": "105886.990367",
                                "percent": "0.3025342582",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "9",
                                "items": []
                            },
                            {
                                "eid": "12d0b1b7-524e-47ac-a7f5-86e3e6b5dbdb",
                                "name": "四川宏达股份有限公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "宏达",
                                "amount": "77561.780565",
                                "percent": "0.2216050873",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "10",
                                "items": []
                            },
                            {
                                "eid": "972508c8-f440-46c7-8e48-60351295e0f5",
                                "name": "四川濠吉食品集团有限公司",
                                "type": "E",
                                "has_problem": "1",
                                "short_name": "濠吉食品",
                                "amount": "17647.781728",
                                "percent": "0.0504222335",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "11",
                                "items": []
                            },
                            {
                                "eid": "4c7c94fb-95a5-47f0-945d-ecc7c58112fe",
                                "name": "汇源集团有限公司",
                                "type": "E",
                                "has_problem": "1",
                                "short_name": "汇源集团有限公司",
                                "amount": "13452.603584",
                                "percent": "0.0384360102",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "12",
                                "items": []
                            },
                            {
                                "eid": "b586a733-339a-4f2e-a02d-aa8de5ef3830",
                                "name": "中国铁路成都局集团有限公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "中国铁路成都局集",
                                "amount": "12491.830457",
                                "percent": "0.0356909442",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "13",
                                "items": []
                            },
                            {
                                "eid": "b31c698a-13d9-41f5-b9b2-57e83a0bdde2",
                                "name": "四川省投资集团有限责任公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "四川省投资",
                                "amount": "4873.363842",
                                "percent": "0.0139238967",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "14",
                                "items": []
                            },
                            {
                                "eid": "33f1a96e-7ef7-4397-929b-d38bad6cddba",
                                "name": "四川成渝高速公路股份有限公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "成渝高速公路",
                                "amount": "4100.176412",
                                "percent": "0.0117147897",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "15",
                                "items": []
                            },
                            {
                                "eid": "9da92d77-c10d-44a4-b643-4373e27100ab",
                                "name": "中铁八局集团有限公司",
                                "type": "E",
                                "has_problem": "1",
                                "short_name": "中铁八局",
                                "amount": "1467.900494",
                                "percent": "0.0041940014",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "16",
                                "items": []
                            },
                            {
                                "eid": "1e7111ec-6885-4772-ae73-1fee1b6d48f1",
                                "name": "中国烟草总公司四川省公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "烟草",
                                "amount": "381.871808",
                                "percent": "0.0010910623",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "17",
                                "items": []
                            }
                        ]
                    },
                    {
                        "eid": "2991ee44-47f3-48b2-a7b1-bff379ab6eff",
                        "name": "成都隼睿企业管理咨询有限公司",
                        "type": "E",
                        "has_problem": "0",
                        "short_name": "隼睿企业管理咨询",
                        "amount": "10.0",
                        "percent": "0.0024038462",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "18",
                        "items": [
                            {
                                "eid": "null",
                                "name": "邱昆",
                                "type": "P",
                                "has_problem": "0",
                                "short_name": "邱昆",
                                "amount": "30.0",
                                "percent": "0.4615384615",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "19",
                                "items": []
                            },
                            {
                                "eid": "null",
                                "name": "解军",
                                "type": "P",
                                "has_problem": "0",
                                "short_name": "解军",
                                "amount": "20.0",
                                "percent": "0.3076923077",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "20",
                                "items": []
                            },
                            {
                                "eid": "null",
                                "name": "付美",
                                "type": "P",
                                "has_problem": "0",
                                "short_name": "付美",
                                "amount": "15.0",
                                "percent": "0.2307692308",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "21",
                                "items": []
                            }
                        ]
                    }
                ]
            },
            {
                "eid": "91d1e05c-0a42-457e-a7ec-d9cf94f4ad4f",
                "name": "四川成电华栋实业有限公司",
                "type": "E",
                "has_problem": "0",
                "short_name": "成电华栋实业",
                "amount": "353.43shares",
                "percent": "0.0678",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "22",
                "items": [
                    {
                        "eid": "e620cec9-63ac-40f2-b896-197100981938",
                        "name": "成都成电物业管理有限公司",
                        "type": "E",
                        "has_problem": "0",
                        "short_name": "成电物业管理",
                        "amount": "280.0",
                        "percent": "1.0",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "23",
                        "items": [
                            {
                                "eid": "4af45b0c-9183-4232-8705-032c96c3bc87",
                                "name": "四川省国投资产托管有限责任公司",
                                "type": "E",
                                "has_problem": "0",
                                "short_name": "国投资产托管",
                                "amount": "145.0",
                                "percent": "1.0",
                                "sh_type": "工商股东",
                                "level": "3",
                                "identifier": "24",
                                "items": []
                            }
                        ]
                    }
                ]
            },
            {
                "eid": "null",
                "name": "胡钢",
                "type": "P",
                "has_problem": "0",
                "short_name": "胡钢",
                "amount": "169.7651shares",
                "percent": "0.0326",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "25",
                "items": []
            },
            {
                "eid": "null",
                "name": "付彬",
                "type": "P",
                "has_problem": "0",
                "short_name": "付彬",
                "amount": "163.765shares",
                "percent": "0.0314",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "26",
                "items": []
            },
            {
                "eid": "74ca7153-dbb3-48e5-a3a7-10a5815d6bad",
                "name": "智合中鹄(成都)企业管理咨询合伙企业(有限合伙)",
                "type": "E",
                "has_problem": "0",
                "short_name": "智合中鹄(成都)",
                "amount": "141.442shares",
                "percent": "0.0271",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "27",
                "items": [
                    {
                        "eid": "null",
                        "name": "付彬",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "付彬",
                        "amount": "42.524",
                        "percent": "0.0985723194",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "28",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "邱昆",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "邱昆",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "29",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "解军",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "解军",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "30",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "王继岷",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "王继岷",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "31",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "王琳",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "王琳",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "32",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "庹春龙",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "庹春龙",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "33",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "付美",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "付美",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "34",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "付丽",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "付丽",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "35",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "丁娟",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "丁娟",
                        "amount": "30.5",
                        "percent": "0.0707002102",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "36",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "杨晓龙",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "杨晓龙",
                        "amount": "27.45",
                        "percent": "0.0636301892",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "37",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "黄鹏",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "黄鹏",
                        "amount": "21.35",
                        "percent": "0.0494901472",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "38",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "黄强",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "黄强",
                        "amount": "18.3",
                        "percent": "0.0424201261",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "39",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "龚国伟",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "龚国伟",
                        "amount": "15.25",
                        "percent": "0.0353501051",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "40",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "李吉庆",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "李吉庆",
                        "amount": "15.25",
                        "percent": "0.0353501051",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "41",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "朱璨",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "朱璨",
                        "amount": "15.25",
                        "percent": "0.0353501051",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "42",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "罗吉",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "罗吉",
                        "amount": "9.15",
                        "percent": "0.0212100631",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "43",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "黄爱萍",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "黄爱萍",
                        "amount": "6.1",
                        "percent": "0.014140042",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "44",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "邓佳丽",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "邓佳丽",
                        "amount": "6.1",
                        "percent": "0.014140042",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "45",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "林志军",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "林志军",
                        "amount": "6.1",
                        "percent": "0.014140042",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "46",
                        "items": []
                    },
                    {
                        "eid": "null",
                        "name": "赵红武",
                        "type": "P",
                        "has_problem": "0",
                        "short_name": "赵红武",
                        "amount": "4.575",
                        "percent": "0.0106050315",
                        "sh_type": "工商股东",
                        "level": "2",
                        "identifier": "47",
                        "items": []
                    }
                ]
            },
            {
                "eid": "null",
                "name": "张传亮",
                "type": "P",
                "has_problem": "0",
                "short_name": "张传亮",
                "amount": "141.372shares",
                "percent": "0.0271",
                "sh_type": "主要股东(新三板)",
                "level": "1",
                "identifier": "48",
                "items": []
            }
        ],
        "p_count": 47,
        "c_count": 0,
        "c_trees": []
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/relation/getRelationInfoByName';
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的值'
}

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);
});