Introduction

Introduction

The Semaphore Semantic Enhancement Service (SES) is designed as a highly available, high throughput, searchable interface to models developed within Semaphore Knowledge Model Management (formerly Ontology Editor). Because it is built on top of the Apache Solr search platform, features such as scalability and fault tolerance that are available from that platform are available to the SES.

From Semaphore version 5.2, the default SOLR configuration was changed to the SES API version 1.2 - see here for more detail about the changes.

Note, all examples assume that the base URL for your SES is http://localhost:8983/ses. Clearly this will depend on the details of your installation and the machine from which the examples are being run. The examples use the Space Missions model that is can be loaded as a plug-in into the Knowledge Model Manager. If you publish this to your local machine all the example URLs should work directly.

All services can be rendered in XML or JSON - the form of the requests for each is indicated in the documentation.

Note when identifiers are used (either in request or response) these will generally be the GUIDs present in the model. It is possible to override these with bespoke identifiers or (from Semaphore 5.2.0 forwards) to use the concept URIs (see Use URIs as identifiers in downstream systems).

Audience

This document is intended for individuals responsible for integrating Semantic Enhancement Service services. It is assumed readers have a good understanding of API usage and specific XML/JSON experience.

Additional documentation available

The following documentation provides additional information that may be helpful to the reader:

• Classification and Language Service Developer’s Guide
• Semaphore Semantic Enhancement Server (SES) Administration