Get Glossary of the API
GET /obp/v7.0.0/api/glossary
OBPv7.0.0-getGlossary No role required Documentation
Returns the Glossary of the API: the union of
- static Glossary Items, compiled into the API and only changing when the API is redeployed, and
- Dynamic Glossary Items, held in the database and maintained with POST, PUT and DELETE on this same path.
A Dynamic Item replaces a static one of the same title. Each entry reports which it is:
is_dynamic— true when the entry comes from the database rather than the API source.overrides_static_item— true when this Dynamic Item is displacing a static Item of the same title. Overriding has to be declared when the Item is created, so this is deliberate; the API also reports these in its logs at startup.glossary_item_id,created_atandupdated_atare present for a Dynamic Item and absent for a static one, which has nothing to manage.created_by_user_idis returned to authenticated callers only.
One Item at a time. GET /obp/v7.0.0/api/glossary/TITLE returns a single Item. Prefer it — the whole Glossary is around a megabyte, which is a lot to download to read one entry.
Optional query parameters:
search— only Items that contain what you type, case insensitively, looking at the title and at the text of the Item. The words are matched one by one and an Item has to contain all of them, sosearch=agent messagesfinds the Item titledSignal Channelseven though neither word is in its title. Items whose titles contain every word are listed before those that only match on their text.source—all(default),staticordynamic.limitandoffset— page the result. Withoutlimitthe whole Glossary is returned, as it always has been.total_countcounts what matched before paging.
This is the same Glossary that GET /obp/v3.0.0/api/glossary returns. That version is STABLE and its JSON cannot change, so it carries neither the fields above nor these parameters.
User Authentication is Optional. The User need not be logged in.
JSON response body fields (9)
- description
- Description of the object. Maximum length is 2000. It can be any characters here.
- glossary_items
- html
- html format content
- is_dynamic
- is_dynamic
- markdown
- overrides_static_item
- overrides_static_item
- shadows_static_glossary_item
- shadows_static_glossary_item
- title
- Dr.
- total_count
- total_count
Example success response
{
"glossary_items": [
{
"title": "Bank.bank_id",
"description": {
"markdown": "The unique identifier of the Bank on this OBP instance.",
"html": "<p>The unique identifier of the Bank on this OBP instance.</p>"
},
"is_dynamic": false,
"overrides_static_item": false,
"shadows_static_glossary_item": false
}
],
"total_count": 1
}Possible errors (2)
- OBP-30578: Invalid source. Please specify all, static or dynamic.
- OBP-50000: Unknown Error.