Safe Stamper Web API callbacks: Difference between revisions
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 …' |
w>Jguillo No edit summary |
||
| 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 == | ||
Revision as of 10:56, 19 April 2016
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"}
]
}