Our Open REST based APIs allow you to integrate NoahFace with your existing IT systems and applications. For example, you could:
The opportunities are endless.
NoahFace can automatically retrieve your list of users from an existing IT system so you don't need to import/export users or manually maintain them in two places. To do this, you simply implement our User Synchronisation API (a REST end-point), and configure NoahFace to call it.
Your implementation of the User Synchronisation API should return JSON data. The JSON data should containing a Users array, which is your list of users. Each user can contain any of the following elements:
The following is an example of the JSON that your API should return. Only the SyncGuid and at least one of the Name and FirstName elements are mandatory for each user.
To enable user synchronisation, simply add a synchronisation instance, select 'Custom' as the type of synchronisation, and specifying your API endpoint details (see example below).
NoahFace can forward user recognition events to your applications or IT systems. To do this, you simply implement our User Recognition API (a REST end-point), and configure NoahFace to call it when a user is recognised.
Your implementation of the User Recognition API should expect to receive the following elements:
Your API can be designed to be called using an HTTP GET, PUT, or POST method. If you use GET, the event data will be sent in query parameters. If you specify PUT or POST, the event data will be sent in JSON format (see example below).
The following is an example of the JSON that your API should expect. All elements will be present even if they are empty.
To forward user recognition events, simply add a notification, select 'Custom' as the type, and specifying your API endpoint details (see example below). Once you have done this, associated this notification with an access point type, and create your access point.
Your implementation of the NoahFace APIs should enforce one of the following authentication methods:
If your implementation of the NoahFace APIs is being designed to service multiple organisations, you should use different credentials for each organisation so you can access the appropriate data in your IT system or application.
Regardless of which authentication method you choose, all API calls are over SSL so your data and credentials are encrypted.