Using RESTful web services

Using REST web services

In this tutorial you will learn how to query CellBase web services using different technologies and programming languages. You are encouraged to visit RESTful Web Services documentation to understand and learn how CellBase web services have been designed and implemented.

There are several public CellBase RESTful servers you can use. In this tutorial we will use EMBL-EBI CellBase host URL www.ebi.ac.uk/cellbase/webservices/rest but you can change it by any other host. You can also follow the Download and Installation and Load Data Models tutorials and install your own RESTful server, then you can use localhost:8080/cellbase/webservices/rest.

Technologies and programming languages:

• [curl](Using RESTful web services#using-curl)
• [Python](Using RESTful web services#using-python)
• [Java](Using RESTful web services#using-java)
• [R](Using RESTful web services#using-r)
• [Javscript](Using RESTful web services#using-javascript)

Using curl

curl is a command line tool and library for transferring data with URL syntax. It supports many different protocols including HTTP what allows to use it to query data.

• Get information of Human genes located in Chromosome 3 between coordinates 55 and 100000; execute

curl http://www.ebi.ac.uk/cellbase/webservices/rest/v3/hsapiens/genomic/region/3:55-100000/gene

• Get all Human variants associated with beta-Thalassemia:

curl http://www.ebi.ac.uk/cellbase/webservices/rest/v3/hsapiens/genomic/variant/beta_Thalassemia/phenotype

• Get information for all Drosophila Melanogaster chromosomes:

curl http://wwwdev.ebi.ac.uk/cellbase/webservices/rest/v3/dmelanogaster/genomic/chromosome/all

Using Python

Python is a general programming language that lets you work quickly and integrate systems more effectively. You can easily query RESTful web services using urllib2 library. This snippet retrieves all the human genes in a particular region.

#!/usr/bin/python

import urllib2
import json
import zlib

url = 'http://wwwdev.ebi.ac.uk/cellbase/webservices/rest/v3/hsapiens/genomic/region/3:1104666-1166667/gene'
req = urllib2.Request(url)
req.add_header("Accept-Encoding", "gzip")

response = urllib2.urlopen(req)
json_data = response.read()

data = zlib.decompress(json_data, 16+zlib.MAX_WBITS)
data = json.loads(data)

print data

Using Java

Using R

Using JavaScript