Skip to content

Developer Documents

Jump to bottom Edit New page
Keiichiro Ono edited this page Oct 21, 2013 · 12 revisions

NeXO RESTful API Version 1 Beta

Introduction

NeXO datasets are fully accessible through simple RESTful API. This is the beta release of API, and some of the method may change in the final version.

Base URL

Our current API server is http://chardonnay.ucsd.edu/

Basic Entry Retrieval (GET methods)

Get Details by ID

Syntax
  • BASE_URL/ID

ID is a unique identifier for terms and genes. For example, term IDs start with namespace, and then ID for the ontology. For genes, SGD IDs are used as unique identifier.

Return Value

A JSON Object

Example

Get Path to the root term

Syntax
  • BASE_URL/ID/path

This return array of paths. First element is always the shortest path to the root, and others are the first neighbour of the term. These first neighbours are hidden in the visualization, and if you want to get those, you need to access this API to get all neighbour terms.

Return value

Array of arrays

Example

Get raw interactions (NeXO only)

Syntax
  • BASE_URL/NEXO_ID/interactions

This returns raw interaction data for the given NeXO term as Cytoscape.js graph object.

Return Value

Cytoscape.js style graph object.

Example

Search by keywords

Syntax
  • BASE_URL/search/NAMESPACE/QUERY

where NAMESPACE is NEXO or GO, and query is a keywords for search.

Return Value

Array of JSON objects. First entry is always the original keywords.

Example

Search by gene names

Syntax
  • BASE_URL/search/genes/GENE_IDS

where GENE_ISD is list of gene names/IDs for search.

Return Value

Array of JSON objects.

Example

Advanced Features (POST methods)

Term Enrichment

Syntax
  • BASE_URL/enrich

You need to post the following parameters as a object:

  • type - Ontology Type (NeXO or GO)
  • genes - List of genes to be tested
  • alpha - Cut-off threshold
Return Value

Array of JSON objects.

Add a custom footer
Add a custom sidebar

Clone this wiki locally