Registration and access process for Condeco APIs

Subscription package

Customers who sign up for the Eptura Engage API service are granted access to the Platinum subscription.

By using notifications services, customers can significantly reduce the number of API endpoint calls made to Eptura Engage. Listener services automatically send notifications of certain data changes, which means endpoint calls are made only when necessary to update data held locally. All customers with access to the Eptura Engage API can easily subscribe to these services.

The current list of available notification (webhooks) listener services:

To access the Eptura Engage API collection you must register for access.

Register and activate the subscription

Follow the steps in API Access: Subscribing to the Eptura Engage APIs

Follow the Authentication steps below to generate the Bearer token value. 

Authentication

There are two authentication headers required in API calls with the Eptura Engage application:

1. Ocp-Apim-Subscription-Key: API security token
2. Session Token: Eptura Engage Application security token also known as the Bearer Token.

Subscription Keys

The subscription keys are assigned after registering. 

A subscription key is provided on your account for each of the following:

• CostCode
• ExternalBookings
• HierarchyMapping
• VendorServices
• Visitor

Learn more about API and Endpoints

Session Token

As well as a subscription key you must provide a validated Session Token to access the Eptura Engage API. Session Tokens are valid for 12 hours. To generate a Session Token, provide the Client ID and Password to your Eptura Engage application e.g. customername.condecosoftware.com. Contact your Eptura Engage representative for these values.

When the parameters are passed, a Session Token is provided for interacting with the Eptura Engage API.

An example JSON object with the access token (Access Token is valid for 12 hours):

{
     "access_token": "eyJ0eXAiOiJKV1Q........excxqRSdf1PqrlI",
     "token_type": "bearer",
     "expires_in": 43199
}