Jump to: navigation, search

Session Management

The Session Management API allows you to bundle requests and set your customer ID for your entire session. This is the technical part of the interface, and its concepts and actions are only of interest to developers.

Authorization

The operations carried out by the Session Management API can be accessed by all roles.

Create Session

Description Creates a new session
URL /sessions/new
Method PUT
Request Content-Type application/json
Response Content-Type application/json
Role Any
URL IDs None
URL Parameters
HTTP Header
Field Type Req Description
gkc_agentId String No Agent ID
gkc_customerId String No Customer ID
Request Body Optional
Field Type Req Description
visitId String No Visit ID
globalVisitId String No Global Visit ID
Response SessionInfo
Notes If successful, 200 OK is returned. However, if the dataset already exists, 400 BAD REQUEST is returned.

Retrieving Session Info

Description Retrieves information about an existing session by sessionId
URL /sessions/{sessionId}
Method GET
Request Content-Type
Response Content-Type application/json
Role Any
URL IDs
Parameter Type Description
{sessionId} String Session ID
HTTP Header
Field Type Req Description
gkc_agentId String No Agent ID
gkc_customerId String No Customer ID
URL parameters None
Response SessionInfo
Notes Returns information about the existing session of the specified ID, or about the new session that was automatically created.

Update Session Information

Description Associates a recognized user with a previously started anonymous session
URL /sessions/{sessionId}
Method POST
Request Content-Type application/json
Response Content-Type application/json
Role Any
URL IDs
Parameter Type Description
{sessionId} String Session ID
HTTP Header
Field Type Req Description
gkc_agentId String No Agent ID
gkc_customerId String No Customer ID
Request Body Optional
Field Type Req Description
visitId String No Visit ID
globalVisitId String No Global Visit ID
Response SessionInfo
Notes If successful, 200 OK is returned. However, if the dataset already exists, 400 BAD REQUEST is returned.
This page was last modified on August 12, 2015, at 06:00.

Feedback

Comment on this article:

blog comments powered by Disqus