Get Metadata Node List
OVERVIEW
Overview
Get a list of metadata nodes from Publisher
This API call is used to retrieve a list of metadata nodes from the system.
Since v5.1
HTTP Request
GET /api/2/metadata?{parameters}
URL Parameters
Parameter | Format | Description |
---|---|---|
search | String |
Will search across all metadata node names or display names for a matching string. This should be the same search as at the top of the metadata admin page Note: This search will duplicate the existing search in the metadata admin page. We will consider multi-lingual metadata search in the future. |
sort | String |
Allow ascending and descending sorting of a single field. GET /metadata?sort=+created This returns a list of metadata nodes sorted by ascending created date. possible fields: name, display name, status, level, created |
limit | String |
Limits the number of metadata nodes returned. GET /metadata?offset=10&limit=5 Default: 20 |
offset | String |
Allows paging of metadata nodes. e.g. GET /metadata?offset=10&limit=5 Default: 0 |
fields | String |
If no fields are specified, a Metadata summary Object will be returned for all nodes (default behaviour) If "all" is specified, the full Metadata node Object will be returned for all metadata nodes GET /api/2/metadata?fields=all |
HTTP Headers
HTTP Request Header | Description | Example |
---|---|---|
Authorization | The API Authorisation token | "Bearer XXXXXXXXXXXXX" |
Accept |
The format of the expected response.
If no parameter is set, JSON is the default response given. |
"application/xml" |
Content-Type |
The format of the provided content.
If no parameter is set, JSON is the expected content by default. |
"application/json" |
HTTP Response
Success
HTTP response 200 with a list of Metadata node summary Objects
(Example below)
Error
Example HTTP Request & Response
Query String: (sort by name)
GET http://example.com/context/api/2/metadata?sort=+name
JSON Response
{
"totalcount": 23,
"total": 4,
"currentpage": 0,
"metadatas": [
{
"id": 3,
"name": "Risk rating",
"link": "http://example.com/context/api/2/metadata/3"
},
{
"id": 4,
"name": "Department",
"link": "http://example.com/context/api/2/metadata/4"
},
{
....
}
]
}
Comments
0 Comments