Adminwiki: 1 revision imported

2023-10-17T11:27:28Z

1 revision imported

← Older revision	Revision as of 07:27, 17 October 2023
(No difference)

api>Admin at 08:13, 29 July 2019

2019-07-29T08:13:07Z

New page

When starting a certification job with [[web/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 [[web/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.

NOTE: These callbacks are independent from the [[API Overview#API callbacks | API callbacks]] sent to the callback URL associated to your API client.

== Example ==

Line breaks have been included in this example content for legibility, but actual callbacks include the whole JSON in a single line.

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

Web API callbacks - Revision history

Adminwiki: 1 revision imported

api>Admin at 08:13, 29 July 2019