From Safe Stamper API
Revision as of 10:07, 9 December 2016 by Admin (talk | contribs)
Jump to: navigation, search

Launches a certified web browsing session.

This operation directly redirects to the session launching page, so it is not a server-to-server API operation. You must build the request URL and redirect the user to that URL in a web browser.



  • sharedkey: Your API client shared key
  • authkey: Authorization key
  • url: The URL where the browsing session should start
  • type: Type of browsing session
    • web_snapshots: Browsing session with screen snapshots
    • web_video: Browsing session with full audio/video recording
  • bringback: URL where the user will be redirected after the browsing session is finished. See #Bringback URL
  • signature: Parameters signature, as explained in Signature parameter


An HTML page that launches the browsing session

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 navigation credits available
  • 430 Your Safe Stamper user has no storage space available


This example launches a browsing session starting at and redirects the user to on completion


Bringback URL

Once the browsing session is finished, the user will be redirected to the specified bringback URL.

The following query string parameters will be appended to the bringback URL:

  • code Certificate code. You can use this code to check if the certificate has been completely processed calling browse/status
  • cancel If this parameter is present with a true value, it indicates that the user cancelled the browsing session.