BioPortal Prototype JSONP Proxy

gistfile1.md

Accessing BioPortal REST API from the browser with JSONP

This is a prototype service. As such, NCBO will not be providing support for its usage.

Signature

• http://bioportal.bioontology.org/ajax/jsonp?path=%2Fontologies&callback=?&apikey=your_api_key&userapikey=user_api_key

Parameters

The endpoint takes a few parameters (* required):

• • path={REST service endpoint path} - this should not include the /bioportal portion and should be url-encoded
• • apikey={your api key}
• userapikey={your user's api key}
• callback={function name} - whatever name your callback function should have
• variable={variable name} - if you want to use a variable, include the name here

The proxy does not handle status codes appropriately. It will always return a 200, even if the REST API responded with a 404 or 500, and in these cases it will embed the status in the JSON with the key 'status'. The body of the response will also be included, in a second key called 'body'. Successful responses will only contain the full body of the response without the 'status' or 'body' keys.

Limitations: only works with GET requests