Web/status

From SafeStamper API documentation
Revision as of 15:27, 17 October 2023 by Adminwiki (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This operation returns the status of a certification job.

URL

https://www.safestamper.com/api/web/status

Parameters

  • sharedkey: Your API client shared key
  • jobId: The job identifier returned by the stamp operation
  • signature: Parameters signature, as explained in Signature parameter

Returns

A JSON object with the following fields:

  • jobId: Job identifier
  • results: Array of JSON objects with the status of each URL included in the certification job
    • url: URL to be certified
    • status: URL status, can be one of the following:
      • INPROGRESS: URL certification is in progress
      • ERROR: The URL could not be certified
      • READY: The URL certificate is ready for download
    • progress: Percentage of completion (for INPROGRESS status)
    • error: Error code (for ERROR status):
      • bad-url: URL is not valid
      • quota-error: User has no certificate credits
      • quota-disk-error: User has no storage space
      • max-size: URL content is too large (more than 5Mb)
      • too-many-redirects: URL has launched more than 10 redirects
      • http-error-XXX: URL returned an HTTP status other than 200 (success) or 30X (redirects)
      • internal-error: Unexpected internal error while processing URL certificate
    • certificateId: Certificate code (for READY status)
    • certificateUrl: Certificate download URL (for READY status)

HTTP Errors

  • 403 Forbidden: the sharedkey or signature are not valid, or the specified job does not belong to the API client
  • 404 Not found: the job id is not correct.

Example

REQUEST:

https://www.safestamper.com/api/web/status
?sharedkey=5hmpod0d2vx7fnh6ysxab3olz
&jobId=c498d3e0-aedb-48fe-82d5-5dec4270318b
&signature=5784ad59c9fb400451887a138bf8ad36cee729d2

RESPONSE (actual response has no line breaks or indentation):

{
   "jobId":"c498d3e0-aedb-48fe-82d5-5dec4270318b",
   "results":[
      {"url":"http://www.safestamper.com","status":"READY",
       "certificateId":"160419-BQS763",
       "certificateUrl":"https://web.safestamper.com/certificate/160419-BQS763"},
      {"url":"NON-VALID-URL","status":"ERROR","error":"bad-url"},
      {"url":"http://www.safecreative.org","status":"INPROGRESS","progress":66}
   ]
}