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.
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
http://dgb-support-lab.digibee.internal:9090/pipeline/dgb-support-lab/v1/test-api-internal
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.
