Proteins Plus Logo

Website Usage Documentation

Please select the service you are interested in:


Tutorial


REST API Usage Documentation

API requests can be sent with the command line tool curl or with a browser rest client plugin. The API allows the user to create jobs for the respective tools with the HTTP method POST, each requiring a different set of parameters.
Calculation results can then be accessed and downloaded with the HTTP method GET. The base url for current version (v1) is https://proteins.plus/api.
For performance and security reasons, the API endpoints are subject to rate limiting (30 jobs/minute). Inidividual rate limits for some of the tools with heavy CPU/RAM usage do exist (e.g., for DoGSiteScorer). Please consider using the offline versions of the tools in case you need higher throughput (Software Server ZBH). Exceeding the limit, a HTTP status code 429 with the message "Throttle limit reached. Retry later" will be sent.
Custom PDBs can be used in order to create tool jobs. These PDBs have to be added priorly:

Sample Call (curl):

curl -F pdb_file[pathvar]=@/path/myfile.pdb -X POST https://proteins.plus/api/pdb_files_rest -H "Accept: application/json"
The HTTP status code 202 is returned if the PDB is still loading and 200 if the PDB was successfully loaded.
400 is returned if an error occurrs. The response contains an id that can subsequently be used for tool calls instead of a pdb code.

Please select the service you are interested in:


KNIME nodes

KNIME is a free open-source and easy to use tool to create workflows to analyze your chemical data. We offer various nodes to integrate the ProteinsPlus tools into your KNIME workflows.