Job Status
==========

https://hexcalc.ucsc.edu/**jobStatus/jobId/<jobId>**

HTTP GET

data-type: json

This API checks the status of a compute job.

Example URL
-----------
::

 https://hexcalc.ucsc.edu/jobStatus/jobId/123

Where '123' is the job ID which is returned from a web API call of the form::

 https://hexcalc.ucsc.edu/query/<operation>

Response success
----------------

This is returned as HTTP 200 with the content something like::

 {
    "status": "Success",
    "result": "some result"
 }

Where:

* **status** : one of:

 * InJobQueue
 * Running
 * Success
 * Error

* **result** : Only Success and Error may have an optional result. This
  property is only present if there is a result. The form of the result depends
  on the status as follows:

 * Success: the calculation result
 * Error: the error message, with an optional stack trace as in this example:

::

 {
    "status": "Error",
    "result": {
        "error" : <errorMessage>,
        "stackTrace" : <stackTrace>
    }
 }

Response error
--------------

Response errors have some HTTP code other than 200, with JSON content that may
contain a stack trace, such as::

 {
    "error" : <errorMessage>,
    "stackTrace" : <trace>
 }