Skip to main content

Table 1 Summary of the OpenTox API, implemented by AMBIT REST services. {service} defaults to "ambit2".

From: AMBIT RESTful web services: an implementation of the OpenTox application programming interface

1. Chemical compound http(s)://host:port/{service}/compound/{id}
GET Retrieves a representation of the chemical compound (in Chemical MIME [32] formats or image/* formats)
PUT Updates the chemical compound
POST Creates a new chemical compound, returns the URI of the new chemical compound
DELETE Deletes the chemical compound
2. Features (or properties) of chemical compounds http(s)://host:port/{service}/feature/{id}
GET Retrieves a representation of the property (RDF representation of the ot:Feature class)
PUT Updates the property representation
POST Creates a new property, returns a URI of the new property
DELETE Deletes the property
3. Datasets of chemical compounds http(s)://host:port/{service}/dataset/{id}
GET Retrieves a representation of the dataset (RDF representation of the ot:Dataset class, or Chemical MIME formats)
PUT Updates the dataset (adds new compounds and/or properties)
POST Creates a new dataset (e.g. uploads a file, which is transformed into a dataset). Returns the new dataset URI, or a Task URI for long running jobs. Parameters are expected in the body of the POST command, several formats are supported via the "Content-type" HTTP header, including RDF and chemical MIME formats.
DELETE Deletes the dataset
4. Algorithms http(s)://host:port/{service}/algorithm/{id}
GET Retrieves a representation of the algorithm (RDF representation of the ot:Algorithm class)
POST • Given a compound URI, or a dataset URI as input parameter, launches the processing algorithm and returns the URI of the dataset, containing the results, or returns a Task URI for long running jobs.
  • If the algorithm is a machine learning one, given a dataset URI as input parameter, builds a new predictive model and returns the Model URI, or the Task URI.
  • Parameters are expected in the body of the POST command, in "application/x-www-form-urlencoded" MIME format.
  • A common required parameter is dataset_uri = http://host:port/{service}/dataset/{datasetid}, which specifies the data set to be operated on.
5. Models http(s)://host:port/{service}/model/{id}
GET Retrieves a representation of the model (RDF representation of the ot:Model class)
POST • Given a compound URI, or a dataset URI as input parameter, applies the predictive model, and returns the URI of the dataset, containing the predictions, or a Task URI for long running jobs.
  • Parameters are expected in the body of POST command, in "application/x- www-form-urlencoded" MIME format.
  • A common required parameter (in the body of the POST command is dataset_uri = http://host:port/{service}/dataset/{datasetid}, which specifies the data set to be operated on.
DELETE Deletes the model
6. Task http(s)://host:port/{service}/task/{id}
GET Retrieves a representation of the task (RDF representation of the ot:Task class). The task status can be one of Queued, Running, Cancelled, Error or Completed.
DELETE Cancels the task
7.Query for compounds http(s)://host:port/{service}/query/compound/{identifier}/{results}
GET Returns compounds, features and feature values, matching the submitted search criteria, in supported formats (dataset representation in RDF, SDF, MOL or SMILES format), according to the mime type requested by the corresponding Accept header:
 identifier - any name, formula, registry identifier, InChI , SMILES, or predefined string "url"; if the string "url" is used, a query parameter is expected ?search=<compound url>
 results - predefined strings: 'names', 'stdinchi', 'all', 'smiles', 'stdinchikey'
8. Ontology http(s)://host:port/ontology
GET Submits a SPARQL query and retrieves the result in "application/sparql-results+xml" format. Requires an input parameter query = "SPARQL"
POST Submits a SPARQL query and retrieves the result in "application/sparql-results+xml" format. Requires an input parameter query = "SPARQL" in the message body in "application/x-www-form- urlencoded" MIME format. Useful for submitting long queries that might exceed the supported URI length.
POST Reads the RDF representation of an OpenTox object and adds it into the triple storage. Requires input parameter uri="OpenTox resource URI"
DELETE Deletes all RDF triples that refer to a given URI. Requires an input parameter uri="OpenTox resource URI"