Safe Stamper Web API callbacks: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
Created page with '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 …'
 
m 2 revisions imported
 
(One intermediate revision by one other user not shown)
Line 3: Line 3:
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.
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.
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 ==
== Example ==

Latest revision as of 08:07, 7 May 2021

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"}
   ]
}