This repository provides a collection of Sample Web Service Clients to consume EBI's Job Dispatcher Web Service tools via REST and SOAP APIs.

New: RESTful API interface is available at https://www.ebi.ac.uk/Tools/common/tools/help/

A collection of REST and SOAP sample clients for the EBI Job Dispatcher Web Services in a range of programming languages.

• Java (*_JAXRS.jar programs)
• Perl > Perl (lwp)
• Python > Python (auto-generated) | Python (urllib) | Python (requests)
• PHP > PHP (php_file)
• Ruby > Ruby (net_http) | Ruby (open-uri)

• C#
• Java (*_Axis1.jar programs)
• Visual Basic .NET
• Perl > Perl (soaplite) | Perl (xmlcompile)
• Python > Python (soappy) | Python (zsi20) | Python (suds)
• PHP > PHP (nusoap) | PHP (php_soap)
• Ruby > Ruby (soap4r)

A selection of utility scripts are provided in the util directory.

Users are encouraged to develop their own clients. Feel free to share them with us! Those will be listed in thirdparty directory.

A selection of sample workflow descriptions showing how to use the services can be found in the following directories:

• Taverna

You can prefer to run the Perl Sample Clients with Docker. We provide a docker container at https://hub.docker.com/r/ebiwp/webservice-clients/.

Pull the webservice-clients container from Docker Hub:

docker pull ebiwp/webservice-clients

Then run the Perl Clients with:

# example
docker run --rm -it ebiwp/webservice-clients ncbiblast_lwp.pl --help

You can control input/output with --volumes or simply -v:

# example
docker run --rm -it -v `pwd`:/results -w /results ebiwp/webservice-clients ncbiblast_lwp.pl  \
  --email your@email.com --stype protein --database uniprotkb_swissprot --program blastp sp:pak4_human

EBI Web Service Perl Clients are also available through BioContainers.

docker pull biocontainers/ebi-webservice

We have got a new project that allows auto-generation of Python clients. See https://github.com/ebi-wp/webservice-client-generator for more details.

If you have any problems, suggestions or comments for our services please contact us via EBI Support.