血缘分析服务_API 调用方式_开发指南

8.1. 描述

    名称：KinshipGraph
    url :   /rest/graph/kinshipGraph.json

血缘分析API提供客户端可以通过I+接口查询，特定业务关系的多度扩展1、支持单个实体2、特定关系是指在后台管理-业务参数-血缘关系配置的关系，一般如果血缘，同户号等3、不支持条件过滤4、支持设置查询度数，不超过5度

8.2. 请求参数

名称	类型	是否必须	描述
objects	String,Array< String >	是	起始节点列表,KV结构，K为实体类型，和I+后台配置相同，V为实体ID数组，参见请求示例
degree	int	否	传值则返回指定度数内的所有路径，不传值默认查询最短路径

8.3. 返回参数

名称	类型	描述
nodeCnt	Integer	网络中实体节点个数
linkCnt	Integer	网络中关系边个数
nodes	Array< Node >	节点列表
id	String	节点id
label	String	节点标签，跟I+后台配置的实体属性一致
type	String	节点类型，如O0001
virtual	Boolean	节点在网络中是否存在
nodesProps	Array< Property >	节点属性列表
< Property >	< String,String >	节点属性KV值，K为节点类型，和I+后台配置的实体类型一致，V为节点属性，比如”O0003P0001”:”张三”
links	Array< Link >	关系边列表
id	String	关系边id
source	String	关系边的源实体id
sourceType	String	关系边的源实体类型，如O0003
target	String	关系边的目标实体id
targetType	String	关系边的目标实体类型，如O0004
linkDetails	Array< String >	关系边包含的边明细记录id列表
linkDetails	Array< LinkDetail >	关系边明细列表
label	String	关系边明细的label
linkId	String	关系边明细的id
linkType	String	关系边明细类型
linkProps	Array< Property >	关系边明细属性列表
< Property >	< String,String >	关系属性KV值，K为关系边属性类型，和I+后台配置的关系边属性类型一致，V为关系边属性值，比如”L0003P0001”:”乘车时间”

8.4. 示例

8.4.1. 请求示例

{
    "degree": "3",
    "objects": {
      "O0003": [
        "O0003P0004-37141137******5795"
      ]
    }
}

8.4.1. 结果示例

{
  "data": {
    "linkCnt": 2,
    "linkDetails": {
      "L0003^27b44b00fcf663b8fdfad968f8a2eba9": {
        "label": "乘火车",
        "linkId": "L0003^27b44b00fcf663b8fdfad968f8a2eba9",
        "linkType": "L0003",
      },
      "L0003^49052e268251cf1b8252c407961e132a": {
          "label": "乘火车",
        "linkId": "L0003^49052e268251cf1b8252c407961e132a",
        "linkType": "L0003"
      }
    },
    "linkProps": {
        "L0003^27b44b00fcf663b8fdfad968f8a2eba9": {
            "L0003P0001":"",
            "L0003P0002":"",
        } ,
        "L0003^49052e268251cf1b8252c407961e132a": {
            "L0003P0001":"",
            "L0003P0002":"",
        }
    },
    "links": [
      {
        "id": "O0003#O0003P0004-89375189******6906^O0004#O0004P0002-HB1163",
        "linkDetails": [
          "L0003^27b44b00fcf663b8fdfad968f8a2eba9"
        ],
        "source": "O0003P0004-89375189******6906",
        "sourceType": "O0003",
        "target": "O0004P0002-HB1163",
        "targetType": "O0004"
      },
      {
        "id": "O0003#O0003P0004-37141137******5795^O0004#O0004P0002-HB1163",
        "linkDetails": [
          "L0003^49052e268251cf1b8252c407961e132a"
        ],
        "source": "O0003P0004-37141137******5795",
        "sourceType": "O0003",
        "target": "O0004P0002-HB1163",
        "targetType": "O0004"
      }
    ],
    "nodeCnt": 3,
    "nodes": {
      "O0003P0004-37141137******5795": {
        "id": "O0003P0004-37141137******5795",
        "label": "李四",
        "type": "O0003",
        "virtual": false
      },
      "O0003P0004-89375189******6906": {
        "id": "O0003P0004-89375189******6906",
        "label": "张三",
        "type": "O0003",
        "virtual": false
      },
      "O0004P0002-HB1163": {
        "id": "O0004P0002-HB1163",
        "label": "HB1163",
        "type": "O0004",
        "virtual": false
      }
    },
    "nodesProps": {
        "O0003P0004-37141137******5795": {
            "O0003P0001":"李四",
            "O0003P0002":"",
            "O0003P0003":"",
            "O0003P0004":"37141137******5795"
        },
        "O0003P0004-89375189******6906": {
            "O0003P0001":"张三",
            "O0003P0002":"",
            "O0003P0003":"",
            "O0003P0004":"89375189******6906"
        },
        "O0004P0002-HB1163": {
            "O0003P0001":"",
            "O0003P0002":"HB1163",
            "O0003P0003":""
        }
    }
  },
  "elapsedTime": 0,
  "noteMsg": "",
  "success": true
}