summaryrefslogtreecommitdiff
path: root/README
blob: a6047d57be11c8f913e60961be64dafc2f5b5cd1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
OpenTox Compounds
=================

* An OpenTox REST Webservice (http://www.opentox.org)

* Uses OpenBabel (http://openbabel.sf.net) and the CACTUS REST webservice (http://cactus.nci.nih.gov/chemical/structure).

* Implements a subset of the OpenTox compounds API (http://opentox.org/wiki/opentox/Structure).

* This version runs at http://webservices.in-silico.ch/compound/v0

REST API

Description             Method  URI                   Parameters  Result          Status codes

Get a representation    GET     /{id}                             Compound        200, 500
of the structure                                                  representation 

Representation defaults to Smiles. InChI, sdf, gif-images and names/synonyms are currently supported
To select a representation you can
  - add the desired extension (smiles|inchi|sdf|imag|names) to the URI, e.g. /{id}.names to get all names 
  - or select the desired mime/type in the request header

Create the URI for a    POST    /                     smiles or   Compound URI    200, 500
compound                                              name

Compounds can be initialized by smiles or name, names can be anything that identifies a compound
(e.g. InChI, InChI Key, CAS, synonyms)

Match a Smarts string   GET     /{id}/match/{smarts}  -           true|false      200, 500

Make sure to URI encode the smarts string!

Indexing (i.e. GET /) and deletion operations are not supported, because objects are not stored.

EXAMPLES

Create an URI for Benzene:

  curl -X POST name=Benzene http://webservices.in-silico.ch/compound/v0

Create an URI for Benzene from the Smiles string:

  curl -X POST smiles='c1ccccc1' http://webservices.in-silico.ch/compound/v0

Get all synonyms for benzene:

  curl http://webservices.in-silico.ch/compound/v0/c1ccccc1.names

Get the SDF File:

  curl http://webservices.in-silico.ch/compound/v0/c1ccccc1.sdf

Can we find a nitrogen in benzene?

  curl http://webservices.in-silico.ch/compound/v0/c1ccccc1/match/N

  Please make sure that smarts strings are URI encoded!


INSTALLATION

Run 'rake install' to install the required gems and openbabel

Copyright (c) 2009 Christoph Helma. See LICENSE for details.