Cipres Portal Web Server REST API
The REST API provides web services for end users to submit a job to the portal programmatically. Currently, only one job submission is allowed for each request.
The REST API provides the same functionality as those provided by the browser-based service with the exception of Bootstap-RaXML (to be added later).

URI HTTP Method CRUD Operation Description Status Codes Description
/restapi/job POST CREATE sbumit a job to server 201(OK),400(Bad Request) [more details]
/restapi/job/{id} GET READ query submitted job status 200(OK),400(Bad Request),404(Not Found) [more details]
/restapi/result/job/{id}/file/{filename} GET READ retrieve submitted job result file 200(OK),400(Bad Request),404(Not Found) [more details]

Flow of the request from job submission to result retrieval:

  1. CLIENT sends POST to submit a job;
    SERVLET returns URL for job status retrieval
  2. CLIENT sends GET to retieve job status using URL from 1;
    SERVLET returns URL to retrieve tmp file or result file;
  3. CLIENT sends GET to retrieve content of tmpfile or result file;
    SERVLET returns content of requested file;