关联反查服务_API 调用方式_开发指南

4.1. 描述

    名称：GetGraph
    url :   /rest/graph/getGraph.json

关联反查API提供客户端可以通过I+接口查询，从一个或多个实体节点出发，查询指定关系的关系网络路径。1、支持多个不同类型的节点出发
2、支持查询多个关系
3、支持定义关系属性的过滤条件
4、支持定义目标节点属性的过滤条件

4.2. 请求参数

名称	类型	是否必须	描述
objects	String,Array<String>	是	起始节点列表,KV结构，K为实体类型，和I+后台配置相同，V为实体ID数组，参见请求示例
links	Array<Link>	是	图查询的需要关系
linkType	String	是	关系类型和I+后台配置相同
direct	int	否	关系出入度，0:出度，1:入度，2:出入度，3:无向，不传默认无向/出入度（支持关联反查，群集分析，共同邻居）
queryProps	Array<String>	否	指定想要查询的属性，默认查询所有属性
propertyList	Array<PropertyFilter>	否	需要过滤关系的属性，详见示例
propertyId	String	否	关系过滤属性的类型
propertyType	String	否	关系过滤属性的查询类型
values	Array<String>	否	详见1.3的其他说明
derivated	Array<PropertyFilter>	否	同字类关系的过滤属性，详见示例，同类为后台管理配置的间接关系，不输入使用后面默认配置
statPropList	Array<statPropFilter>	否	累计属性条件过滤，用于数值类型sum,count值过滤，属性后台配置，支持关联反查，群集分析，共同邻居
propertyId	string	否	固定值，一般为linkType+T+基础属性ID(次数为P000) 例：L0001TP000
propertyType	string	否	固定为number
values	List<String>	否	同基础属性
statType	int	否	统计条件类型，0按属性值/次数查询，1 按属性值/次数的排序号查询
targetObjects	Array<ObjectFilter>	否	目标节点的属性过滤，详见示例
objectType	String	是	节点类型和I+后台配置相同
propertyList	Array<PropertyFilter>	否	需要目标节点的属性，详见示例
propertyId	String	否	目标节点过滤属性的类型
propertyType	String	否	目标节点过滤属性的类别
values	Array<String>	否	目标节点过滤属性的值

4.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”:”乘车时间”

4.4. 示例

4.4.1. 请求示例

{
    "objects": {
      "O0003": [
        "O0003P0004-37141137******5795",
        "O0003P0004-89375189******6906"
      ],
      "O0004":[
          "O0004P0002-HB1163",
          "O0004P0002-HB1985",
          "O0004P0002-HB4999"
      ]
    },
    "links": [
      {
        "linkType": "L0003",
        "propertyList": [],
        "derivated": []
      },
      {
        "linkType": "L0004",
        "propertyList": [
          {
            "propertyId": "L0004CC002",
            "propertyType": "string_like",
            "values": [
              "11"
            ]
          }
        ],
        "derivated": [
          {
            "count": {
              "propertyType": "string_equal",
              "values": [
                "1"
              ]
            },
            "propIds": [
              "L0004CC002"
            ],
            "intervaltime": []
          }
        ]
      }
    ],
    "targetObjects": [
      {
        "objectType": "O0003",
        "propertyList": [
          {
            "propertyId": "O0003P0002",
            "propertyType": "string_like",
            "values": [
              "22"
            ]
          }
        ]
      }
    ]
}

4.4.2. 返回示例

{
  "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
}