If the API changes in an incompatible manner this is listed explicitly in the "important release notes" section of each releases changelog.
Client app setup data | |
---|---|
Request | GET /editor/plugins_termportal_data |
Params | locale=(en|de) Optional. default 'en'. See titles in |
Term search | |
---|---|
Request | GET /editor/plugins_termportal_data/search |
Params | query * Required. Search query. Wildcard characters '*' and '?' are supported for multi- and single-char searches, respectively. |
language Required. ID of language which searched terms belong to. See lang in Client app setup data response structure | |
limit Requred. Results limit per page. Integer value expected. | |
start Required. Results offset. Integer value expected. | |
clientIds Optional. Comma-separated list of integers, representing client IDs. See | |
collectionIds Optional. Comma-separated list of integers, representing collection IDs. See filterWindow.collections in Client app setup data response structure | |
processStatus Optional. Comma-separated list of any of 'unprocessed', 'provisionallyProcessed', 'finalized' and 'rejected'. | |
noTermDefinedFor Optional. ID of language, that term is not yet defined for | |
attr-x Optional. Attribute search, where 'x' - is the key in filterWindow.attributes (see Client app setup data response structure). If param name is mentioned among request params but no param value given, the search will return the terms having such attributes defined even despite having empty value. If param value is given, wildcard characters '*' and '?' are supported, first for multichar and second for single-char purpose. Multiple attributes search are supported, just use attr-x, attr-y etc | |
termEntryTbxId Optional. Partially known tbx ids are supported | |
termTbxId Optional. Partially known tbx ids are supported | |
tbxCreatedBy Optional. ID of person who was specified as creator in imported tbx data (see filterWindow.tbxCreatedBy array in Client app setup data response structure) | |
tbxCreatedGt Optional. Should be used to search terms created since certain date, inclusively, according to imported tbx data. Value is expected in format yyyy-mm-dd. Can be used with tbxCreatedLt if search by date range is needed. | |
tbxCreatedLt Optional. Should be used to search terms created until certain date, inclusively, according to imported tbx data. Value is expected in format yyyy-mm-dd. Can be used with tbxCreatedGt if search by date range is needed. | |
tbxCreatedAt Optional. Exact date of creation specified in imported tbx data. Date in format yyyy-mm-dd is expected. This can only be used if f tbxCreatedGt and tbxCreatedLt are NOT given | |
tbxUpdatedBy Optional. ID of person who was specified as updater in imported tbx data (see filterWindow.tbxUpdatedBy array in Client app setup data response structure) | |
tbxUpdatedGt Optional. Should be used to search terms updated since certain date, inclusively, according to imported tbx data. Value is expected in format yyyy-mm-dd. Can be used with tbxUpdatedLt if search by date range is needed. | |
tbxUpdatedLt Optional. Should be used to search terms updated until certain date, inclusively, according to imported tbx data. Value is expected in format yyyy-mm-dd. Can be used with tbxUpdatedGt if search by date range is needed. | |
tbxUpdatedAt Optional. Exact date of creation specified in imported tbx data. Date in format yyyy-mm-dd is expected. This can only be used if tbxUpdatedGt and tbxUpdatedLt are NOT given | |
Response { "totalCount": 5, "data": [ { "id": "187459", "collectionId": "82", "termEntryId": "16610", "languageId": "5", "term": "federated database", "proposal": "", "processStatus": "provisionallyProcessed", "status": "admittedTerm", "definition": "language-level definition", "termEntryTbxId": "c6", "collectionName": "C:\\fakepath\\TBX-basic-sample" }, { "id": "573874", "collectionId": "82", "termEntryId": "16611", "languageId": "5", "term": "progressive power lens1", "proposal": "progressive power lens", "processStatus": "provisionallyProcessed", "status": "deprecatedTerm", "definition": "entry-level def2", "termEntryTbxId": "c7", "collectionName": "C:\\fakepath\\TBX-basic-sample" }, ... ] } |
Get attributes and siblings for a specific term | |
---|---|
Request | POST /editor/plugins_termportal_data/terminfo |
Params | termId Required. ID of term we need to get info about |
Response contains attributes for this particular term itself, for it's language-level, and for it's ternEntry-level, under 'term', 'language' and 'entry' keys, respectively. Also, response object contains the array of all other terms that belong to the same termEntry that current term belongs to. FYI: the requested term is NOT excluded from the list of siblings. |
Get attributes for a specific term | |
---|---|
Request | POST /editor/plugins_termportal_data/siblinginfo |
Params | termId Required. ID of term we need to get info about |
Response | Same as for 'terminfo', described above, except two things:
|
Provides access to the Term collections available in the application.
URL: | /editor/term/[ID] |
Available Methods: | GET / POST / PUT / DELETE |
Operations (POST) | /editor/term/[ID]/propose/operation /editor/term/[ID]/confirmProposal/operation |
Specialities: | - |
Resource Layout
Name | Type | Info |
id | int | GET only |
term | string | The term itself |
mid | string | A textual mid used in the TBX file |
status | string | The term status, one of: preferredTerm, admittedTerm, legalTerm, regulatedTerm, standardizedTerm, deprecatedTerm, supersededTerm |
processStatus | string | The current processing status of a term, one of: unprocessed, provisionallyProcessed, finalized |
definition | string | The term describing definition |
groupId | string | The mid of the termEntry |
language | integer | the internal language id of the term |
collectionId | integer | the collection id of the collection to which the term belongs |
termEntryId | integer | the internal term entry id of the term entry to which the term belongs |
created | timestamp | GET only, Date and time when the term collection is created |
updated | timestamp | GET only, Date and time when the term collection is updated |
proposal | object | GET only, null, or an object containing the proposal data object. |
Propose Operation
URL: | /editor/term/[ID]/propose/operation |
Available Methods: | POST |
Description | Creates a new proposal for the term |
POST Data (form encoded) | data={"term": "New Proposal"} |
Confirm Proposal Operation
URL: | /editor/term/[ID]/confirmproposal/operation |
Available Methods: | POST |
Description | Confirms a proposal and takes it over into the term itself. |
POST Data | - |