Generating an API request from Postman

d.motta · November 21, 2022, 9:00pm

Often when creating API queries, users have questions about the correctness of the required parameters.

To generate an API request:

Navigate to the ElectroNeek API documentation portal.
Select the endpoint according to your organization.

If you go to the API documentation through the user portal (Orchestrator SaaS → Integrations → API → “Documentation”), the endpoint will be automatically selected according to the region of the organization under which you are logged in to the portal.
To transfer data via an API request, we need the API request to trigger the execution of the algorithm. For this, we will use the method
POST /workflow/{id}/launch.
The API request will look like this:
{{endpoint}}/workflow/{id}/launch, where:

{{endpoint}} — https://api.emea.electroneek.com/v1/orchestrator (if the region of the organization is EMEA region)
{id} — id of the workflow to be launched. To find it:

Navigate to electroneek.com → Orchestrator SaaS → «Workflows»
In the list of published algorithms, find the one you want and click on the line with its name to open the detailed information.
To the right of the algorithm name will be the “Copy ID” button. Click it - the algorithm ID will be copied to the clipboard.

Тhat way, the URL of the API request should look like this:
https://api.emea.electroneek.com/v1/orchestrator//workflow/63283044e233d047bbaefed6/launch
Go to Postman. Select the POST method and paste the URL to the input field.

Create a new header in the “Headers” tab:
Key - Authorization.
Value - Api-Key {{API token}}, for example: Api-Key WEeiVabGIMClWmoS162yJQSzIdEuqiE4.

Press «Send». If everything is filled out correctly, the API request will start the bot. The result will return the following value (where launch_id will correspond with the ID of the workflow):

Happy Automation!!!