XML Schema

Ubisecure CustomerID REST API XML Schema

cid-2.1.xsd for https://HOSTNAME/customerid-rest/services/2.1/ endpoint.
cid-2.0.xsd for https://HOSTNAME/customerid-rest/services/2.0/ endpoint.
cid-1.2.xsd for https://HOSTNAME/eidm2/services/ and https://HOSTNAME/customerid-rest/services/ endpoints.

The <any> element in the response objects is an extension point for the future versions of the API. The server is not sending any un-documented elements.

Error Messages

Error Response Document

HTTP status code always indicates the success or failure of the operation. Additional information about the failure is provided in the response body which may or may not be utilized by the requester.

<error>
	<code>ERRORCODE</code>
	<message>MESSAGE</message>
</error>

Error Codes

Invalid arguments
Authentication failed
Unauthorized
Already exists
Parent not found
Internal server error
Entity not found
Parent not virtual
Parent not non-virtual
Invalid reference
Partial success
Size limit exceeded
Method not allowed
Client error
Configuration conflict

Success Messages

Success Messages for Create, Delete, and Modification Operations

1.2 Schema

<idlist>
 <Id>https://HOSTNAME/eidm2/services/org/example1/dep1</Id>
</idlist>

2.0 and 2.1 Schema

<COLLECTIONTYPE inResponseTo="customerid-rest/services/2.x/RESOURCE" method="METHODNAME">
 <Id>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</Id>
</COLLECTIONTYPE>

COLLECTIONTYPE can be: Users, Roles and Workflows. RESOURCE depends on the specific REST call that was made. METHODNAME can be in these cases one of the following: POST, PUT or DELETE.

Success Messages for Request-Operations

1.2 Schema

Collection Request (list of identifiers)

<idlist>
 <Id>https://HOSTNAME/eidm2/services/org/example1/dep1</Id>
 <Id>https://HOSTNAME/eidm2/services/org/example1/dep2/sub3</Id>
 <Id>https://HOSTNAME/eidm2/services/org/example1</Id>
</idlist>

Collection Request (list of entities)

<entitylist>
 <ENTITY_ELEMENT>
  <Id>https://HOSTNAME/eidm2/services/org/example1/dep1</Id>
  <entity specific...>
   .
  </...entity specific>
 </ENTITY_ELEMENT>
 <ENTITY_ELEMENT>
  <Id>https://HOSTNAME/eidm2/services/org/example1/dep2/sub3</Id>
  <entity specific...>
   .
  </...entity specific>
 </ENTITY_ELEMENT>
 <ENTITY_ELEMENT>
  <Id>https://HOSTNAME/eidm2/services/org/example1</Id>
  <entity specific...>
   .
  </...entity specific>
 </ENTITY_ELEMENT>
</entitylist>

Entity Request

<ENTITY_ELEMENT>
 <Id>https://HOSTNAME/eidm2/services/org/example1/dep1</Id>
 <entity specific...>
  .
  .
  .
 </...entity specific>
</ENTITY_ELEMENT>

2.0 and 2.1 Schema

Collection Request (list of identifiers)

Collections are returned as idlists. These result from requests resources base path (e.g. https://HOSTNAME/customerid-rest/services/2.x/users) or relational queries, such as roles or mandates associated with organization, user or mandate.

<COLLECTIONTYPE xmlns="http://schema.ubisecure.com/customerid/api" inResponseTo="https://HOSTNAME/customerid-rest/services/2.x/COLLECTIONTYPE" method="GET">
 <Id>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX1</Id>
 <Id>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX2</Id>
 <Id>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX3</Id>
</COLLECTIONTYPE>

Entity Request

Entity requests are typically performed to the collection path followed by a specific entity's id

<ENTITY_ELEMENT xmlns="http://schema.ubisecure.com/customerid/api" inResponseTo="https://HOSTNAME/customerid-rest/services/2.x/COLLECTIONTYPE/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" method="GET">
 <Attribute name="ATTRIBUTENAME">
  <Value>VALUE1 </Value>
  <Value>VALUE2 </Value>
 </Attribute>
</ENTITY_ELEMENT>

Endpoint specific responses

In addition to the general purpose types there can be endpoint specific response types in CID 2.1. schema, for instance ReinviteResponse. The specific types are explained within REST API 2.1 - CustomerID operations.

Browser not supported