Safe Stamper Web API callbacks
Jump to navigation
Jump to search
When starting a certification job with stamp you can provide a callback URL.
Once the certification job is finished, the callback URL will receive a POST call with the same JSON object as returned in the status operation.
To authenticate the callback, the JSON object HMAC-SHA1 will be calculated using the API client private key and will be provided as a query string signature parameter.
Example
Line breaks have been included in this example content for legibility, but actual callbacks include the whole JSON in a single line.
POST /stamper-callback?signature=743ae4504eb41cbfe2d2e72dac76a27613333a53 HTTP/1.1 Host: example.com Content-Type: application/json Content-Length: 377 { "jobId":"c498d3e0-aedb-48fe-82d5-5dec4270318b", "results":[ {"url":"http://www.safestamper.com","status":"READY","certificateId":"160419-BQS763","certificateUrl":"https://arena-web.safestamper.com/certificate/160419-BQS763"}, {"url":"NON-VALID-URL","status":"ERROR","error":"bad-url"}, {"url":"http://www.safecreative.org","status":"READY","certificateId":"160419-2LYD3K","certificateUrl":"https://arena-web.safestamper.com/certificate/160419-2LYD3K"} ] }