Services within the Seme4 Platform generally operate in accordance with the principles of RESTful web services and/or Linked Data best practices for accessing structured data on the web.
The OS 'different' Service is an instance of the RelationshipService, which provides storage and query facilities for relationships between pairs of items.
You can interact with it using the following methods.
/os/
Default service homepage, giving description, licence and other information.
GET
/os/admin/
Perform administration tasks
GET
Administration page
Note: this method requires authentication
POST
Administration page
Note: this method requires authentication
/os/admin/:command
Perform a specified administration command
GET
Invoke :command. Valid operations are create, drop, calc and empty.
Note: this method requires authentication
/os/canons/:symbol/
Deal with the canon state associated with a symbol.
GET
Get the canon state of a symbol
PUT
Make the symbol a canon
Note: this method requires authentication
DELETE
Make the symbol not a canon
Note: this method requires authentication
/os/hidden/
Manage and query mass hidden symbols
GET
Dump hidden symbols
Note: this method is not currently available
PUT
Restore hidden symbols
Note: this method is not currently available
Note: this method requires authentication
DELETE
Mass unhide symbols
Note: this method is not currently available
Note: this method requires authentication
/os/hidden/:symbol/
Manage and query single symbol hiding
GET
Find out if symbol is hidden
Note: this method is not currently available
PUT
Hide symbol
Note: this method requires authentication
DELETE
Unhide symbol
Note: this method requires authentication
/os/pairs/
Deal with large numbers of pairs at once
GET
Dump listing of all pairs within the relationship store or maybe modified by the service it is on
PUT
Send a load of pairs to the store
Note: this method requires authentication
DELETE
Send a load of unpairs to the store - currently deletes all pairs
Note: this method requires authentication
/os/pairs/:symbol1/:symbol2/
Query, assert or retract relationship between two items
GET
Query to see if there is a relationship between symbol1 and symbol2. Transitive relationships will be shown.
PUT
Assert that there is a relationship between symbol1 and symbol2
For example you could do (remember to urlencode any URIs):
curl -X PUT http://{service-root}/pairs/God/Jesus
Note: this method requires authentication
DELETE
Remove relationship between symbol1 and symbol2
Note: this method requires authentication
/os/search/
Provide a search facility
GET
Search for a symbol using the provided 'symbol' query argument
/os/status/
Default service status page.
GET
/os/symbols/:symbol/
Do the single symbol stuff
GET
Find the bundle for symbol
PUT
Create a singelton bundle that has symbol in it
Note: this method is not currently available
Note: this method requires authentication
DELETE
Isolate symbol from all other symbols
Note: this method requires authentication
/os/symbols/:symbol/details/
Get the full information about symbol
GET
symbol
Note: this method is not currently available
/os/symbols/:symbol/filter/
Deal with the filter value associated with a symbol.
GET
Get the filter value for symbol
PUT
Set the filter value for symbol
Note: this method requires authentication
DELETE
Reset the filter value for symbol
Note: this method requires authentication
/os/usage/
Usage page - renders the description you are currently reading :)
GET