Skip to main content

 

Eptura Knowledge Center

Integrate sensor partner services with the Condeco API

  1. Last updated
  2. Save as PDF

Introduction

Customers who want to integrate sensors with Condeco must initiate the conversation with the sensor partner. The customer must provide the sensor partner with the required information and request the sensor partner to create a Condeco API account to access the customer's Condeco APIs.

The customer must provide the sensor partner with the following:

  • Customer's Condeco API product names. For example: 
    • [customer]_ExternalBookings_Platinum  
    • [customer]_HierarchyMapping_Platinum
  • Customer's Condeco API client ID and password. The customer can raise a Condeco support ticket to retrieve the Condeco API client ID and password. When retrieved, the information can be shared with the sensor partner via the agreed method.
  • Access to the customer's Condeco API. Learn how to provide access to the Condeco API

In addition, the sensor partner needs the customer's Condeco API URL and OCP subscription key. Both items can be retrieved from the APIM portal by the sensor partner once they have access to the customer's Condeco API. Learn how to retrieve the customer's Condeco API URL and OCP subscription key

How to provide Condeco API access to a sensor partner

The process to provide a sensor partner access to the customer's Condeco API requires actions from the customer, the sensor partner, and Condeco support. Each step depends on the previous step(s) being successfully completed. Certain information must only be provided directly from the customer to the sensor partner or Condeco support, or vice versa.

Process overview

A high-level overview of the actions required and who actions them:

  1. Sensor partner
    1. Create Condeco API account.
    2. Advise customer of account details.
  2. Customer
    1. Raise Condeco service request (1) to add new Condeco API account to APIM resource group that allows access to the customer's API endpoints.
    2. Share their Condeco API product names with the sensor partner .
  3. Condeco support
    1. Add Condeco API account to customer's APIM resource group.
  4. Sensor partner
    1. Use the APIM portal to submit the product(s) for activation.
  5. Customer
    1. Raise Condeco service request (2) to request the submissions are approved.
  6. Condeco support
    1. Approve the submissions to activate the product(s).

Customers who want to integrate sensors with Condeco must initiate the sensor partner's access to the Condeco APIs.

The customer should ask the sensor partner to perform the following steps to create a Condeco API account.

I. Action: Sensor partner
  1. Click Sign up via the appropriate URL:
    1. Production: http://integrationportal.condecosoftware.com
    2. UAT : <condeco> developer portal
  2. Complete the required details (email, password, name, etc.) and click Sign up. A verification request is sent to the email address.

    placeholder 3.png

  3. Find the email 'Please confirm your new Condeco API account' and follow the steps to verify the email address.

  4. The sensor partner advise the customer of the verified email address for the new Condeco API account.

II. Action: Customer

When the customer has received the account details from the sensor partner, the customer follows the steps to notify Condeco support.

  1. The customer raises a Condeco service request from https://support.condecosoftware.com/s/ to request that the new Condeco API account (created by the sensor partner) is added to the relevant APIM resource group that allows access to the customer's API endpoints.
III. Action: Condeco support
  1. The sensor partner's Condeco API account is added to the customer's APIM resource group.
IV. Action: Sensor partner

The sensor partner's account can now see the requested Condeco API products in the APIM portal. For example:

  • [customer]_ExternalBookings_Platinum
  • [customer]_HierarchyMapping_Platinum.
  1. The sensor partner signs in to the APIM portal, click the Products tab and click the required product(s) to subscribe.

    placeholder 4.png

When subscribed, the requested product state in the Profile displays Submitted.

placeholder 5.png

V. Action: Customer

When the sensor partner has submitted the product(s), the customer follows the steps to notify Condeco support.

  1. The customer raises a Condeco service request from https://support.condecosoftware.com/s/ providing the name of the submitted product(s) and the sensor partner's account details and requests the submission(s) is approved.
VI. Action: Condeco support
  1. The submission(s) is approved and the product is activated.

The product state now shows as Active in the Profile.

The Condeco API endpoints can now be accessed by the sensor partner using the APIM portal.

How to retrieve the customer's Condeco API URL and OCP subscription key

To configure the integration, the sensor partner requires the customer's Condeco URL and OCP subscription key. Both items can be retrieved from the APIM portal once they have access to the customer's Condeco API. 

No access to the customer's API? Learn how to provide access to the Condeco API

URL for Condeco API

Sign in to the APIM portal and navigate to APIs from the menu across the top. The customer's API should be listed - click the API to open. From any of the API endpoints, the URL is shown under Request. 

3.png

OCP subscription key

Sign in to the APIM portal and navigate to Profile from the menu across the top. Click Show to display the Primary key.

placeholder 2.png