Stamp: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
m (8 revisions imported)
 
(3 intermediate revisions by one other user not shown)
Line 7: Line 7:
* '''sharedkey''': Your API client shared key
* '''sharedkey''': Your API client shared key
* '''url''N''''': The URLs you want to certificate. Multiple URLs can be specified as url1, url2, etc.
* '''url''N''''': The URLs you want to certificate. Multiple URLs can be specified as url1, url2, etc.
* '''callback''': Callback URL to call when the job is finished (optional)
* '''withUrls''': Include in the certificate a listing with all URLs accessed during page load (optional, defaults to false)
* '''callback''': Callback URL to call when the job is finished (optional). See [[Safe Stamper Web API callbacks | Callbacks]]
* '''signature''': Parameters signature, as explained in [[Safe Stamper Web API parameters signature]]
* '''signature''': Parameters signature, as explained in [[Safe Stamper Web API parameters signature]]



Latest revision as of 08:07, 7 May 2021

Launches a certification job

URL

https://web.safestamper.com/api/stamp

Parameters

  • sharedkey: Your API client shared key
  • urlN: The URLs you want to certificate. Multiple URLs can be specified as url1, url2, etc.
  • withUrls: Include in the certificate a listing with all URLs accessed during page load (optional, defaults to false)
  • callback: Callback URL to call when the job is finished (optional). See Callbacks
  • signature: Parameters signature, as explained in Safe Stamper Web API parameters signature

Returns

A job identifier that can be used to check the status of the operation with status.

It returns the identifier between double quotes, in order to be a valid JSON.

HTTP Errors

  • 403 Forbidden, the sharedkey or signature are not valid
  • 429 Your Safe Stamper user has no certification credits available
  • 430 Your Safe Stamper user has no storage space available

Example

REQUEST:

https://web.safestamper.com/api/stamp
?sharedkey=5hmpod0d2vx7fnh6ysxab3olz
&url1=http%3A%2F%2Fwww.safestamper.com
&url2=NON-VALID-URL
&url3=http%3A%2F%2Fwww.safecreative.org
&signature=aa052389e2d9d508dbb8fc0ef9cb72abc12c7109

RESPONSE:

"c498d3e0-aedb-48fe-82d5-5dec4270318b"