Jump to: navigation, search

Query identity

ApiRef2.png
GET /identities/${identityId}

Description

Retrieves a given identity.

Operation

Method GET
URL /identities/${identityId}
Name   Value Mandatory Description
URI Parameters
${identityId} string yes Identity identifier.
include_visits
  • true
  • false
no If true, the returned identity contains the reference list of associated visits.
include_visits_detail
  • true (if include_visits=true)
  • false
no If true, the returned identity contains the associated visit resources. You can only use this parameter if include_visits is set to true.
include_sessions
  • true
  • false
no If true, the returned identity contains the reference list of authentication sessions.
include_sessions_detail
  • true (if include_sessions=true)
  • false
no If true, the returned identity contains the associated sessions. You can only use this parameter if include_sessions is set to true.
include_pages
  • true
  • false
no If true, the returned identity contains the reference list of the associated pages.
include_pages_detail
  • true (if include_pages=true)
  • false
no If true, the returned identity contains the associated pages. You can only use this parameter if include_pages is set to true.
include_events
  • true
  • false
no If true, the returned identity contains the reference list of associated events.
include_events_detail
  • true (if include_events=true)
  • false
no If true,  the returned identity contains the associated events.
You can only use this parameter if include_events is set to true.

<references />

Response

The History REST API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See HTTP Response Codes and Errors for further details on the possible codes that this operation can return.

HTTP code 200
HTTP Title OK
Body  JSON Identity.

Examples

The following operation retrieves the identity resource with pat.thompsom@genesyslab.com ID. Request

http://192.168.73.246:9081/backend/data/identities/pat.thompsom@genesyslab.com

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}]










This page was last modified on February 15, 2013, at 09:01.

Feedback

Comment on this article:

blog comments powered by Disqus