Level Nodes
Overview
Retrieve nodes of a level (from 2 to 5) matching a name, or a volatile identifier.
- The children nodes of the next level are included.
- When the node is a level 5 node, the children are objects with a permanent ID.
- The children are sorted by name.
As a use case, the following URI reports all target objects of Java unclassified API for application “Shopizer_2_17_0”:
/rest/applications/Shopizer_2.17.0/levels/5/nodes?select=children&name=API%20-%20Java%20unclassified
URI
GET /rest/applications/{name}/levels/{level}/nodes?name={string}&select=children
GET /rest/applications/{name}/levels/{level}/nodes?_id={integer}&select=children
Path parameters
name (string)
This parameter identifies the analyzed application. The application name must be properly encoded if it is required. Character back-quote is not allowed.
level (integer)
The taxonomy level.
Query parameters
name (string)
Required if _id
is not present. A substring of the node name to match. The matching is case insensitive. The string must be properly encoded if it is required (character &
must be encoded with %26
).
_id (integer)
Required if name is not present. A volatile and local ID to identify a node in the scope of the Level
graph.
select (string)
Required. Force to retrieve the list of children nodes for each node. The value children
is required.
Responses
application/json
A list of nodes matching the input name, and for each node, the list of aggregated nodes (or objects for a level 5 node).
Level is between 2 and 4
[
{
"_id": 263283,
"level": 2,
"name": "Batch Services",
"children": [
{
"_id": 263282,
"name": "Script Batch Interfaces"?
"level": 3
}
]
}
]
JSON representation
Property | Type | Description |
---|---|---|
nodes[]._id | integer | A volatile and local ID to identify a node in the scope of the ‘Level’ graph. This ID cannot be used as a path parameter for any URI. |
nodes[].name | string | The parent node name |
nodes[].level | integer | The parent node level |
nodes[].children[]._id | integer | This is a volatile and local ID to identify a child node in the scope of the ‘Level’ graph. This ID cannot be used as a path parameter for any URI. |
nodes[].children[].name | integer | The child node name. |
nodes[].children[].level | integer | The child node level. |
Level is 5
[
{
"_id": 263300,
"name": "API itextpdf",
"level": 5,
"children": [
{
"id": "419",
"name": "VerticalAlignment",
"fullName": "com.itextpdf.layout.properties.VerticalAlignment",
"type": "Java Enum",
"typeId": "JV_ENUM"
}
{
"id": "1026",
"name": "ElementPropertyContainer<T extends com.itextpdf.layout.IPropertyContainer>",
"fullName": "com.itextpdf.layout.ElementPropertyContainer",
"type": "Generic Java Class",
"typeId": "JV_GENERIC_CLASS"
}
]
}
]
JSON representation
Property | Type | Description |
---|---|---|
nodes[]._id | integer | A volatile and local ID to identify a node in the scope of the ‘Level’ graph. This ID cannot be used as a path parameter for any URI. |
nodes[].name | string | The parent node name |
nodes[].level | integer | The parent node level which is 5. |
nodes[].children[].id | string | The object ID. |
nodes[].children[].name | string | The object name. |
nodes[].children[].fullName | string | The object long name, usually locates the object in a software architecture. |
nodes[].children[].type | string | The object type for a display. |
nodes[].children[].typeId | string | The object type identifier is the type reference key. |