Web Services Development with Adama


Status message

New Feature: Guest Login function added to facilitate site exploration without registering. Try it out!

Araport developers create web services using a tool called Adama. Adama is an Araport server-side software component. Adama is a web service that lets Araport users install and manage their own web services. The Adama home page has additional documentation about adapter types.

Adama allows users to identify source code via a URL to a public source code repository hosted somewhere like GitHub. The source code performs an adapter function by standing between the Araport user and some third party data provider. Currently, Adama accepts only codes written in Python and metadata written in YAML.

Adama installs the adapter to a containerized environment on a virtual machine within the Araport server environment. Once installed, the adapter offers an Araport URL and runs as proxy to the third party service. Installed adapters benefit from Araport's central location, automatic documentation, authentication and logging, and technical support.

Adama adapters expose a limited set of endpoints. (Endpoint?? The word "search" is the endpoint in a URL like "http://api.araport.org/community/0.3/myspace/myservice/search?param=value".) Passthru adapters have one main endpoint, access, which may be called with HTTP GET or HTTP POST. Query adapters have two main endpoints: list provides a list of IDs, and search retrieves details about one ID. All adapters also support secondary endpoints such as icon (retrieves an image), prov (returns provenance information such as author and publication), stats (usage statistics), and health (server statistics).