系统预制函数请求格式(JSON)
下面这个请求:
curl -X GET "http://server_ip:9000/endpoints?builtin=true"
会生成如下输出结果。该输出在调整完格式后大约为400行。除了列出所有端点之外,该JSON格式的输出结果还会列出每一个端点必须的参数和可选的参数。对应每个参数,还会列举出对应的属性名。
default
max_count
min_count
type
max_length
is_id
id_type
由于这些内容本身并不足以让我们完全理解每一个端点,所以额外的描述性参数名和属性值则起到了补充说明的作用。
{
"DELETE /graph/{graph_name}/delete_by_type/vertices/{vertex_type}" : {
"parameters" : {
"ack" : {
"default" : "all",
"max_count" : 1,
"min_count" : 1,
"options" : [ "all", "none" ],
"type" : "STRING"
},
"permanent" : {
"default" : "false",
"max_count" : 1,
"min_count" : 1,
"type" : "BOOL"
},
"vertex_type" : {
"type" : "TYPENAME"
}
}
},
"DELETE /graph/{graph_name}/edges/{source_vertex_type}/{source_vertex_id}/{edge_type}/{target_vertex_type}/{target_vertex_id}" : {
"parameters" : {
"edge_type" : {
"max_count" : 1,
"min_count" : 0,
"type" : "STRING"
},
"filter" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"limit" : {
"max_count" : 1,
"min_count" : 0,
"type" : "UINT64"
},
"not_wildcard" : {
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
},
"permanent" : {
"default" : "false",
"max_count" : 1,
"min_count" : 1,
"type" : "BOOL"
},
"select" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"sort" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"source_vertex_id" : {
"id_type" : "$source_vertex_type",
"is_id" : true,
"max_count" : 1,
"max_length" : 256,
"min_count" : 1,
"type" : "STRING"
},
"source_vertex_type" : {
"max_count" : 1,
"min_count" : 1,
"type" : "TYPENAME"
},
"target_vertex_id" : {
"id_type" : "$target_vertex_type",
"is_id" : true,
"max_count" : 1,
"max_length" : 256,
"min_count" : 0,
"type" : "STRING"
},
"target_vertex_type" : {
"max_count" : 1,
"min_count" : 0,
"type" : "TYPENAME"
},
"timeout" : {
"default" : "0",
"max_count" : 1,
"min_count" : 0,
"type" : "UINT32"
}
}
},
"DELETE /graph/{graph_name}/vertices/{vertex_type}/{vertex_id}" : {
"parameters" : {
"filter" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"limit" : {
"max_count" : 1,
"min_count" : 0,
"type" : "UINT64"
},
"permanent" : {
"default" : "false",
"max_count" : 1,
"min_count" : 1,
"type" : "BOOL"
},
"sort" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"timeout" : {
"default" : "0",
"max_count" : 1,
"min_count" : 0,
"type" : "UINT32"
},
"vertex_id" : {
"id_type" : "$vertex_type",
"is_id" : true,
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"vertex_type" : {
"type" : "TYPENAME"
}
}
},
"GET /echo" : {
"parameters" : {
"sleep" : {
"default" : "0",
"type" : "INT32"
}
}
},
"GET /endpoints" : {
"parameters" : {
"builtin" : {
"default" : "false",
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
},
"dynamic" : {
"default" : "false",
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
},
"static" : {
"default" : "false",
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
}
}
},
"GET /graph/{graph_name}/edges/{source_vertex_type}/{source_vertex_id}/{edge_type}/{target_vertex_type}/{target_vertex_id}" : {
"parameters" : {
"count_only" : {
"default" : "false",
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
},
"edge_type" : {
"max_count" : 1,
"min_count" : 0,
"type" : "STRING"
},
"filter" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"limit" : {
"max_count" : 1,
"min_count" : 0,
"type" : "UINT64"
},
"not_wildcard" : {
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
},
"select" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"sort" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"source_vertex_id" : {
"id_type" : "$source_vertex_type",
"is_id" : true,
"max_count" : 1,
"max_length" : 256,
"min_count" : 1,
"type" : "STRING"
},
"source_vertex_type" : {
"max_count" : 1,
"min_count" : 1,
"type" : "TYPENAME"
},
"target_vertex_id" : {
"id_type" : "$target_vertex_type",
"is_id" : true,
"max_count" : 1,
"max_length" : 256,
"min_count" : 0,
"type" : "STRING"
},
"target_vertex_type" : {
"max_count" : 1,
"min_count" : 0,
"type" : "TYPENAME"
},
"timeout" : {
"default" : "0",
"max_count" : 1,
"min_count" : 0,
"type" : "UINT32"
}
}
},
"GET /graph/{graph_name}/vertices/{vertex_type}/{vertex_id}" : {
"parameters" : {
"count_only" : {
"default" : "false",
"max_count" : 1,
"min_count" : 0,
"type" : "BOOL"
},
"filter" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"limit" : {
"max_count" : 1,
"min_count" : 0,
"type" : "UINT64"
},
"select" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"sort" : {
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"timeout" : {
"default" : "0",
"max_count" : 1,
"min_count" : 0,
"type" : "UINT32"
},
"vertex_id" : {
"id_type" : "$vertex_type",
"is_id" : true,
"max_count" : 1,
"max_length" : 2560,
"min_count" : 0,
"type" : "STRING"
},
"vertex_type" : {
"type" : "TYPENAME"
}
}
},
"GET /statistics" : {
"parameters" : {
"seconds" : {
"default" : "10",
"type" : "UINT32"
},
"segments" : {
"default" : "10",
"max" : "100",
"min" : "1",
"type" : "UINT32"
}
}
},
"GET /version" : null,
"POST /builtins" : null,
"POST /ddl/{graph_name}" : {
"parameters" : {
"ack" : {
"default" : "all",
"max_count" : 1,
"min_count" : 1,
"options" : [ "all", "none" ],
"type" : "STRING"
},
"concise" : {
"default" : "false",
"max_count" : 1,
"min_count" : 1,
"type" : "BOOL"
},
"eol" : {
"default" : "\n",
"max_count" : 1,
"max_length" : 4,
"min_count" : 0,
"min_length" : 1,
"type" : "STRING"
},
"filename" : {
"default" : "__GSQL_FILENAME__",
"max_count" : 1,
"min_count" : 0,
"type" : "STRING"
},
"sep" : {
"default" : ",",
"max_count" : 1,
"max_length" : 4,
"min_count" : 0,
"min_length" : 1,
"type" : "STRING"
},
"tag" : {
"max_count" : 1,
"min_count" : 1,
"type" : "STRING"
},
"timeout" : {
"default" : "0",
"max_count" : 1,
"min_count" : 0,
"type" : "UINT32"
}
}
},
"POST /echo" : {
"parameters" : {
"sleep" : {
"default" : "0",
"type" : "INT32"
}
}
},
"POST /graph/{graph_name}" : {
"parameters" : {
"ack" : {
"default" : "all",
"max_count" : 1,
"min_count" : 1,
"options" : [ "all", "none" ],
"type" : "STRING"
}
}
}
}
Last updated