GET /glossary/api/v4/admin/attributelist

GET /glossary/api/v4/admin/attributelist

Use this URI to enable the client to query the list of ordered attributes that are available to look up as details for a business term. Requires a valid JSESSIONID cookie as part of this request.
These attributes are configured and enabled for API access by an administrator in the Analyst Service.

Returns

A list of attributes available for return through the Business Glossary API.
The returned list is random. The returned order number starts from 0.

Return Values

The following table describes the list of return values for the GET /glossary/api/v4/admin/attributelist URI request:
Field
Description
attributes
The details of an attribute.
id
Unique identifier such as name or description.
label
Returns attribute names as the localized display names.
order
Random order.
dataType
Datatype of the attribute. Datatype can be STRING, INTEGER, BOOLEAN, DATE.
default
The number of users.

Responses

The following responses can occur for the GET /glossary/api/v4/admin/attributelist URI request:
HTTP Return Code: 200
Response for an attribute list request. For example:
{ "processingTime": 341, "attributes": [ { "id": "infa_description", "label": "Description", "order": 0, "description": "Description of the Glossary asset.", "dataType": "STRING", "default": false }, { "id": "related_term", "label": "Related Terms", "order": 1, "description": "Other business terms that are related to this business term.", "dataType": "STRING", "default": false }, { "id": "usageContext", "label": "Usage Context", "order": 2, "description": "Contextual description to show how a business term can be used.", "dataType": "STRING", "default": false }, { "id": "steward", "label": "Data Steward", "order": 3, "description": "User who manages a Glossary asset.", "dataType": "STRING", "default": false }, { "id": "referenceTableURL", "label": "Reference Table URL", "order": 4, "description": "URL of the reference table.", "dataType": "STRING", "default": false }, { "id": "phase", "label": "Phase", "order": 5, "description": "Current phase in the lifecycle of the Glossary asset.", "dataType": "STRING", "default": false }, { "id": "example", "label": "Example", "order": 6, "description": "Example showing the business term in use.", "dataType": "STRING", "default": false }, { "id": "owner", "label": "Owner", "order": 7, "description": "Business owner of the Glossary asset.", "dataType": "STRING", "default": false }, { "id": "name", "label": "Name", "order": 8, "description": "Name of the Glossary asset.", "dataType": "STRING", "default": false }, { "id": "status", "label": "Status", "order": 9, "description": "Current status in the lifecycle of the Glossary asset.", "dataType": "STRING", "default": false } ] }
HTTP Return Code: 401
Session is expired. For example:
{ "errorCode": "BG1002", "message": "The token has expired. Authenticate again." } { "errorCode": "BG1006", "message": "The request is not valid, or the authToken is not valid." }
HTTP Return Code: 403
This API method will not return an error.
HTTP Return Code: 404
This API method will not return an error.
HTTP Return Code: 500
Response for an internal error that occurs when accessing a business term. For example:
{ "errorCode": "BG1004", "message": "Internal error." }

0 COMMENTS

We’d like to hear from you!