Maintenance Notice - PDF Generation
Dynamic PDF generation for web-based content is temporarily unavailable. This maintenance affects dynamic PDF files that are generated from either the HTML-based page or manual that you are viewing. Links that normally allow this functionality have been hidden, and will reappear as soon as the feature is restored.

Note: Access to static files, including PDF files that are not dynamically generated from our web-based content, is unaffected.

Jump to: navigation, search

Get Identification Keys

Prerequisites: You need to enable profiles in UCS.
GET /metadata/identification-keys


Returns the identification keys.


Get Identification Keys
Method GET
  • All: /metadata/identification-keys
  • Key: /metadata/identification-keys/${key-name}
Name   Type   Mandatory Description
URI Parameter
${key-name} string no The unique, case-insensitive name of the key. The name must start with a letter, and can be followed with letters, numbers, or underscores. The name is restricted to a maximum of 26 characters. (Maximum RDBMS shared limit on creation of index.)
If you do not specify this parameter, all keys are returned.


The Context Management Service 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 message OK

<references />


The following request retrieves all the identification keys: Operation

 GET /metadata/identification-keys


Let's consider a customer profile which consists of the customer's name, the date of birth, and the external ID (the customer’s ID in an external system such as a CRM). Further assume that a single extension, Contacts, include various attributes such as the phone_number. If you set up the Context Management Server to allow the customer identification via name+birthdate, external ID, or phone number, then the returned result is the following:

 [{"name": "idNameBD", "attributes": ["name", " birthdate"]},
 {"name": "idExt", "attributes": ["external_id"], "unique": true}, 
 {"name": "idPhone", "attributes": ["phone_number"]}
 {"name": "idExtension", "attributes": ["ext.code",""]}]
If the identification key was created off an extension, attributes that are part of the extension are prefixed with the extension name. In the previous example, "idExtension" was built on the extension "ext".
This page was last edited on April 27, 2017, at 10:04.


Comment on this article:

blog comments powered by Disqus