Jump to: navigation, search

Identity Resource

ApiRef2.png
Describes the identity resource.

Description

The identity resource contains the customer information and is created when the Backend Server receives the SignIn event. The browser tier generates this event when the customer signs in (or get authenticated with the company web portal). The identification information submitted by the customer is used to create the identity ID (for instance, teh e-mail address or an account name). Additionally, it creates a new session with a unique session ID across the visit, which becomes the new active session for the current visit. At this point, the identification scope of the customer is Authenticated. If the customer signs out, the Backend Server receives the SignOut event and the identification scope becomes Recognized. For further information on events, see Event Resource.

Resource Details

Field Type Mandatory Description
identityId string yes The unique ID of the given identity. The user provides the identityId information when registering on the website; for instance, it can be the e-mail address.
name string no User name.
location string no User location.
entityInCS string no Entity in the Contact Server. (TBC -> Contact ID?)
visitScope Authenticated,

Recognized

yes Specify the visit's identification scope of the user. If the user is authenticated, you can retrieve session information. If the user signs out, the visit scope changes to recognized.
eventIds string[] no Array of event IDs<ref name="guid">GUID (Globally Unique Identifier)</ref> associated with this identity.
events event[] no Array of the event resources associated with this identity.
pageIds string[] no Array of page IDs<ref name="guid"/> associated with this identity.
pages page[] no Array of the page resources associated with this identity.
sessionIds string[] no Array of session IDs<ref name="guid"/> associated with this identity.
sessions session[] no Array of the session resources associated with this identity.
visitIds string[] no Array of visit IDs<ref name="guid"/> associated with this identity.
visits visit[] no Array of the visit resources associated with this identity.

<references />

Related Operations

Examples

Retrieving Identities

The following operation retrieves all the identities available. Request

GET http://192.168.73.246:9081/backend/data/identities

Response

HTTP/1.1 200 OK
Date: Wed, 12 Dec 2012 15:17:09 GMT
Content-Type: application/json; charset=UTF-8
Date: Wed, 12 Dec 2012 15:17:09 GMT
Accept-Ranges: bytes
Server: Restlet-Framework/2.1.0
Content-Length: 477
[{"eventIds":null,"events":null,"pageIds":null,"pages":null,
"sessionIds":null,"sessions":null,"identityId":"pat.thompsom@genesyslab.com",
"name":null,"location":null,"entityInCS":null,"visitScope":"Authenticated",
"visitIds":null,"visits":null},
{"eventIds":null,"events":null,"pageIds":null,"pages":null,
"sessionIds":null,"sessions":null,"identityId":"user@genesyslab.com",
"name":null,"location":null,"entityInCS":null,"visitScope":"Authenticated",
"visitIds":null,"visits":null}]

Retrieving Identities with page IDs

The following operation retrieves all the identities available, including the associated page IDs. Request

GET /backend/data/identities?include_pages=true

Response

HTTP/1.1 200 OK
Date: Wed, 12 Dec 2012 15:28:13 GMT
Content-Type: application/json; charset=UTF-8
Date: Wed, 12 Dec 2012 15:28:13 GMT
Accept-Ranges: bytes
Server: Restlet-Framework/2.1.0
Content-Length: 627
[{"eventIds":null,"events":null,
"pageIds":["11ff6de0-446e-11e2-bfd2-00505625a04f"],
"pages":null,"sessionIds":null,"sessions":null,"
identityId":"pat.thompsom@genesyslab.com",
"name":null,"location":null,"entityInCS":null,
"visitScope":"Authenticated","visitIds":null,
"visits":null},
{"eventIds":null,"events":null,
"pageIds":["45f0eda1-3fa4-11e2-aee5-00505625a04f","c489cac0-3fa3-11e2-aee5-00505625a04f",
"06afd7f0-3fa4-11e2-aee50505625a04f"],"pages":null,"sessionIds":null,
"sessions":null,"identityId":"user@genesyslab.com",
"name":null,"location":null,"entityInCS":null,"visitScope":"Authenticated",
"visitIds":null,"visits":null}]






This page was last edited on February 15, 2013, at 16:01.
Comments or questions about this documentation? Contact us for support!