Identity Manager 9.1 - API Development Guide

To implement your own APIs, you can create API plugins.

The API Server loads all DLLs matching the *.CompositionApi.Server.PlugIn.dll naming scheme and deploys the API definitions contained therein.

To implement your own API

Create an API plugin (see Creating and editing API plugins).
Compile the appropriate TypeScript API client (see Compiling TypeScript API clients).

Implementing your own APIs > Creating and editing API plugins

With the help of API plugins, you can implement and use your customized APIs.

Prerequisites:

To create an API plugin

Start your IDE (such as Visual Studio).
Create a new .NET Framework 4.8 project named CCC.CompositionApi.Server.Plugin.
Add references to the following DLL files from the One Identity Manager installation directory:
- QBM.CompositionApi.Server.dll
- VI.Base.dll
- VI.DB.dll
Create the API code.
Compile the DLL file in your IDE.
Import the DLL file into your One Identity Manager database using the Software Loader and assign it to the Business API Server machine role. For more information on importing files using the Software Loader, see the One Identity Manager Operational Guide.
Restart the API Server and ensure that the CCC.CompositionApi.Server.Plugin.dll file is present.

To edit an existing API plugin

Start your IDE (such as Visual Studio).
Open the existing .NET Framework 4.8 project.
Edit the API code.
Compile the DLL file in your IDE.
Import the DLL file into your One Identity Manager database using the Software Loader and assign it to the Business API Server machine role. For more information on importing files using the Software Loader, see the One Identity Manager Operational Guide.
Restart the API Server and ensure that the CCC.CompositionApi.Server.Plugin.dll file is present.

Implementing your own APIs > Compiling TypeScript API clients

After you create an API plugin, you need to compile a corresponding TypeScript API client.

To compile a TypeScript API client

Open a command line prompt.
Run the following command:
```
imxclient compile-api -N -W /copyapi imx-api-ccc.tgz /packagename imx-api-ccc
```
The dialog to select the database connection is opened.
In the dialog, perform one of the following actions:
- to use an existing connection to the One Identity Manager database, select it in the Select a database connection menu.
  
  - OR -
- to create a new connection to the One Identity Manager database, click Add new connection and enter a new connection.
Select the authentication method and, under Authentication method, enter the login data for the database.
Click Log in.
Import the imx-api-ccc npm package into your TypeScript application.

You can use the ImxClient command line tool to run different functions for managing the API Server and files on the command line.