全部产品
云市场

关联反查服务

更新时间:2018-01-03 16:31:53

4.1. 描述

  1. 名称:GetGraph
  2. 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. 请求示例
  1. {
  2. "objects": {
  3. "O0003": [
  4. "O0003P0004-37141137******5795",
  5. "O0003P0004-89375189******6906"
  6. ],
  7. "O0004":[
  8. "O0004P0002-HB1163",
  9. "O0004P0002-HB1985",
  10. "O0004P0002-HB4999"
  11. ]
  12. },
  13. "links": [
  14. {
  15. "linkType": "L0003",
  16. "propertyList": [],
  17. "derivated": []
  18. },
  19. {
  20. "linkType": "L0004",
  21. "propertyList": [
  22. {
  23. "propertyId": "L0004CC002",
  24. "propertyType": "string_like",
  25. "values": [
  26. "11"
  27. ]
  28. }
  29. ],
  30. "derivated": [
  31. {
  32. "count": {
  33. "propertyType": "string_equal",
  34. "values": [
  35. "1"
  36. ]
  37. },
  38. "propIds": [
  39. "L0004CC002"
  40. ],
  41. "intervaltime": []
  42. }
  43. ]
  44. }
  45. ],
  46. "targetObjects": [
  47. {
  48. "objectType": "O0003",
  49. "propertyList": [
  50. {
  51. "propertyId": "O0003P0002",
  52. "propertyType": "string_like",
  53. "values": [
  54. "22"
  55. ]
  56. }
  57. ]
  58. }
  59. ]
  60. }
4.4.2. 返回示例
  1. {
  2. "data": {
  3. "linkCnt": 2,
  4. "linkDetails": {
  5. "L0003^27b44b00fcf663b8fdfad968f8a2eba9": {
  6. "label": "乘火车",
  7. "linkId": "L0003^27b44b00fcf663b8fdfad968f8a2eba9",
  8. "linkType": "L0003",
  9. },
  10. "L0003^49052e268251cf1b8252c407961e132a": {
  11. "label": "乘火车",
  12. "linkId": "L0003^49052e268251cf1b8252c407961e132a",
  13. "linkType": "L0003"
  14. }
  15. },
  16. "linkProps": {
  17. "L0003^27b44b00fcf663b8fdfad968f8a2eba9": {
  18. "L0003P0001":"",
  19. "L0003P0002":"",
  20. } ,
  21. "L0003^49052e268251cf1b8252c407961e132a": {
  22. "L0003P0001":"",
  23. "L0003P0002":"",
  24. }
  25. },
  26. "links": [
  27. {
  28. "id": "O0003#O0003P0004-89375189******6906^O0004#O0004P0002-HB1163",
  29. "linkDetails": [
  30. "L0003^27b44b00fcf663b8fdfad968f8a2eba9"
  31. ],
  32. "source": "O0003P0004-89375189******6906",
  33. "sourceType": "O0003",
  34. "target": "O0004P0002-HB1163",
  35. "targetType": "O0004"
  36. },
  37. {
  38. "id": "O0003#O0003P0004-37141137******5795^O0004#O0004P0002-HB1163",
  39. "linkDetails": [
  40. "L0003^49052e268251cf1b8252c407961e132a"
  41. ],
  42. "source": "O0003P0004-37141137******5795",
  43. "sourceType": "O0003",
  44. "target": "O0004P0002-HB1163",
  45. "targetType": "O0004"
  46. }
  47. ],
  48. "nodeCnt": 3,
  49. "nodes": {
  50. "O0003P0004-37141137******5795": {
  51. "id": "O0003P0004-37141137******5795",
  52. "label": "李四",
  53. "type": "O0003",
  54. "virtual": false
  55. },
  56. "O0003P0004-89375189******6906": {
  57. "id": "O0003P0004-89375189******6906",
  58. "label": "张三",
  59. "type": "O0003",
  60. "virtual": false
  61. },
  62. "O0004P0002-HB1163": {
  63. "id": "O0004P0002-HB1163",
  64. "label": "HB1163",
  65. "type": "O0004",
  66. "virtual": false
  67. }
  68. },
  69. "nodesProps": {
  70. "O0003P0004-37141137******5795": {
  71. "O0003P0001":"李四",
  72. "O0003P0002":"",
  73. "O0003P0003":"",
  74. "O0003P0004":"37141137******5795"
  75. },
  76. "O0003P0004-89375189******6906": {
  77. "O0003P0001":"张三",
  78. "O0003P0002":"",
  79. "O0003P0003":"",
  80. "O0003P0004":"89375189******6906"
  81. },
  82. "O0004P0002-HB1163": {
  83. "O0003P0001":"",
  84. "O0003P0002":"HB1163",
  85. "O0003P0003":""
  86. }
  87. }
  88. },
  89. "elapsedTime": 0,
  90. "noteMsg": "",
  91. "success": true
  92. }