Semaphore Concepts Service

The Concepts Service presents a highly available read-only version of Published models. New to Semaphore 5.8, it is similar in functionality to the Semantic Enhancement Server but is not a drop-in replacement as the two APIs are not the same.

We have taken the opportunity with the new service of returning purely JSON representations of the data. These representations better reflect the structure of the Semaphore data (SES is backwards compatibly to Semaphore 3 where the representation was different).

The Concepts Server is available via

• REST calls - documented here - also via a Swagger interface from the server itself at <concepts_server_base_uri>/q/swagger-ui/ for example: http://localhost:5092/q/swagger-ui/
• GraphQL - this is available at <concepts_server_base_uri>/q/graphql-ui/ for example: http://localhost:5092/q/graphql-ui/.

Permissions for changing data on the Concept Server are as with the Semantic Enhancement Server and Classification and Language Server. As part of the environment set up within Studio, you can “adopt” the Concepts Server instance. This means that permissions will be managed by that Studio instance. You can then assign permissions to users to be able to either just publish to the instance or to administrate it more generally. If you want to publish to the Concept Server from outside of the Studio instance, you will need to provide an authentication token as a header - “X-Token” - to your requests. This token is accessible from the service management page within Studio.