RESTful Realtime Functions

The RESTful resources that manage live co-browse sessions are sub-resources of <cobrowse-app>/rest/live. For example, http://127.0.0.1:8700/cobrowse/rest/live

Create Session

Request URL	/sessions
HTTP Method	POST
Description	Creates a new Co-browse session.

Response:

{
  "sessionToken": "845800826",
  "sessionServerName": "Co-browse_Server"
}

The HTTP response has a cookie, gcbSessionServer, which should stick further HTTP requests to the server hosting the created session.

Get Session

Request URL	/sessions/{id}
HTTP Method	GET
Description	Returns live session public data. The main purpose is to determine which server the session is hosted on (this is needed to integrate the agent Co-browse plug-in with the Co-browse cluster). The id is the live session ID.

Response:

{
  "sessionToken": "845800826",
  "sessionServerName": "Co-browse_Server"
}

Stop Session

Request URL	/users/{userToken}/session/stop
HTTP Method	GET
Description	Initiates Co-browse session deactivation for the Controller's session. userToken is the Controller's userToken.

Response

{
  "activationTime": 1368722791040, // UTC time stamp in ms
  "deactivationTime": 1368722820929 // UTC time stamp in ms
}