Browse/stamp

From Safe Stamper API
Revision as of 09:59, 9 December 2016 by Admin (talk | contribs) (Created page with "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 ...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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.

URL

https://www.safestamper.com/api/browse/stamp

Parameters

  • 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 Web browsing API bringbacks
  • signature: Parameters signature, as explained in Signature parameter

Returns

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

Example

This example launches a browsing session starting at https://www.safestamper.com and redirects the user to https://www.example.com/bringback on completion

REQUEST:

https://www.safestamper.com/api/browse/stamp
?sharedkey=5hmpod0d2vx7fnh6ysxab3olz
&authkey=115a88b6-7420-4837-b6e5-fd231b02b1cd
&url=https%3A%2F%2Fwww.safestamper.com
&type=web_snapshots
&bringback=https%3A%2F%2Fwww.example.com%2Fbringback
&signature=5edc8b14a1e0937238cace104a42e8a1096e05c1