All Collections
Understand how to use the Internal API on the Digibee Integration Platform
Understand how to use the Internal API on the Digibee Integration Platform

This article covers how to publish and consume an API on the internal gateway of the Digibee Integration Platform.

Guilherme Jola Ferreira avatar
Written by Guilherme Jola Ferreira
Updated over a week ago

It is possible to publish your organization's pipelines for internal and/or external use. For internal use, the API is made available exclusively on the internal gateway of your cluster, allowing access by other pipelines within your realm or via VPN. For external use, the API is also accessible over the internet, enabling interaction with external applications and services.

The triggers that currently have this functionality are HTTP, HTTP-FILE, and REST.

Enabling Internal API in the realm

The internal API is not enabled by default in the realm. To do so, please contact Digibee's support team. (It needs to be enabled once in the realm to be used in your pipelines).

By default, the hostname {{realmname}}.digibee.internal and ports 7070 (PROD) and 9090 (TEST) will be made available.

Configuring Internal API in the Pipeline (REST Trigger)

Let's use the scenario below as an example:

Realm: dgb-support-lab

Host: dgb-support-lab.digibee.internal

Port (test): 9090

Port (prod): 7070

Pipeline name: test-api-internal

We configured the REST trigger in the pipeline named "test-api-internal." (Remember to assign this pipeline to an API Key).

After deploying the pipeline in the TEST environment, the following endpoint will be made available:

https://{replace with Digibee internal host}/pipeline/dgb-support-lab/v1/test-api-internal

Now, to consume this endpoint, you must replace {replace with Digibee internal host} with the internal host along with the port.

Host: dgb-support-lab.digibee.internal
Port (test): 9090


Use HTTP instead of HTTPS.

How to consume an Internal API:

Now you can trigger your Endpoint through a pipeline using the REST V2 component or the Pipeline Executor, as well as from an external application, provided that it has an established VPN connection with your realm.

Here's an example using the REST V2 component.

Did this answer your question?