Stamp

From Safe Creative API
Revision as of 10:58, 19 April 2016 by w>Jguillo (→‎Parameters)
Jump to navigation Jump to search

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.
  • 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"