Web/stamp: Difference between revisions
Jump to navigation
Jump to search
api>Admin |
|||
| (One intermediate revision by the same user not shown) | |||
| Line 11: | Line 11: | ||
* '''withHeaders''': Include in the certificate a listing with all headers received from each URL. Requires withUrls=true. (optional, defaults to false) | * '''withHeaders''': Include in the certificate a listing with all headers received from each URL. Requires withUrls=true. (optional, defaults to false) | ||
* '''acceptCookies''': Accept cookies automatically when accessing the URL for certification (optional, defaults to false) | * '''acceptCookies''': Accept cookies automatically when accessing the URL for certification (optional, defaults to false) | ||
* '''proxy''': Choose location proxy for capture (optional, defaults to none) | |||
** ''none'': No proxy (capture from Ireland) | |||
** ''ES'': Launch capture from Spain | |||
** ''DE'': Launch capture from Germany | |||
** ''US'': Launch capture from USA | |||
* '''callback''': Callback URL to call when the job is finished (optional). See [[Web API callbacks]] | * '''callback''': Callback URL to call when the job is finished (optional). See [[Web API callbacks]] | ||
* '''signature''': Parameters signature, as explained in [[Signature parameter]] | * '''signature''': Parameters signature, as explained in [[Signature parameter]] | ||
Latest revision as of 02:47, 24 April 2026
Launches a static web page certification job
URL
https://www.safestamper.com/api/web/stamp
Parameters
- sharedkey: Your API client shared key
- authkey: Authorization 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)
- withHeaders: Include in the certificate a listing with all headers received from each URL. Requires withUrls=true. (optional, defaults to false)
- acceptCookies: Accept cookies automatically when accessing the URL for certification (optional, defaults to false)
- proxy: Choose location proxy for capture (optional, defaults to none)
- none: No proxy (capture from Ireland)
- ES: Launch capture from Spain
- DE: Launch capture from Germany
- US: Launch capture from USA
- callback: Callback URL to call when the job is finished (optional). See Web API callbacks
- signature: Parameters signature, as explained in Signature parameter
Returns
A job identifier that can be used to check the status of the operation with web/status.
The identifier is returned between double quotes, in order to be a valid JSON value.
HTTP Errors
- 403 Forbidden, the sharedkey or signature are not valid
- 401 Unauthorized, the authkey is 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://www.safestamper.com/api/web/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"