Difference between revisions of "Web Services REST API"

From CoGepedia
Jump to: navigation, search
m (2. CoGe Web Services API (RESTful))
Line 1: Line 1:
There are two main ways a programmer can interact with CoGe:
+
==CoGe Web Services RESTful API==
#Through the web pages via URLs
+
#Through CoGe's web services API (Application Programming Interface)
+
  
==1. Linking to CoGe==
+
CoGe's web services API let's you incorporate CoGe's database of organisms, genomes, and data sets into your web site or pipeline.
 
+
Each web application of CoGe is designed for a particular task, and provides links to other web applications in CoGe.  This is how CoGe's [[Open-ended Analysis Network]] works.  To get information on how to link to a particular web application, please see that application's wiki.  If the information you are seeking is not immediately apparent, please feel free to e-mail [mailto:elyons@berkeley.edu Eric Lyons] and for help.
+
 
+
==2. CoGe Web Services API (RESTful)==
+
 
+
We are currently developing public web services for accessing and loading data in CoGe!
+
  
 
Here is our draft API specification document:<br>
 
Here is our draft API specification document:<br>

Revision as of 16:44, 14 April 2014

CoGe Web Services RESTful API

CoGe's web services API let's you incorporate CoGe's database of organisms, genomes, and data sets into your web site or pipeline.

Here is our draft API specification document:
http://docs.google.com/document/d/1GXOPIVvyTwoGR2IRjDNmdd2nj_6d8db7jx9hG8RxTDc


Below are some examples queries ...


Organism Search

curl http://genomevolution.org/coge/api/v1/organisms/search/col-0
{
   "organisms":
      [
         {
            "id": "1",
            "name": "Arabidopsis thaliana Col-0 (thale cress)",    
            "description": "Eukaryota; Viridiplantae; Streptophyta; Embryophyta; Tracheophyta; Spermatophyta; Magnoliophyta; eudicotyledons; core eudicotyledons; rosids; eurosids II; Brassicales; Brassicaceae; Arabidopsis"
         }
      ]
}

Organism Fetch

curl http://genomevolution.org/coge/api/v1/organisms/1
{
   "id": 1,
   "name": "Arabidopsis thaliana Col-0 (thale cress)",
   "description": "Eukaryota; Viridiplantae; Streptophyta; Embryophyta; Tracheophyta; Spermatophyta; Magnoliophyta; eudicotyledons; core eudicotyledons; rosids; eurosids II; Brassicales; Brassicaceae; Arabidopsis"
   “genomes” : [ 16911, ... ]
}

Genome Fetch

curl http://genomevolution.org/coge/api/v1/genomes/16911
{
   "id": 16911
   "name": "",
   "description": "",
   "version": "10.02",
   "link": "",
   "restricted": false,
   "sequence_type": {
      "name": "unmasked",
      "description": "unmasked sequence data"
   },
   "experiments": [31,32,33, ...],
   "metadata": [],
}