gPanel API

Disclaimer: This is a gPanel Enterprise-exclusive feature. You must have an active Enterprise subscription in order to access the gPanel API. To learn more about gPanel Enterprise and speak with sales about demos/pricing, click here

Step 1 - Create an Account

Begin by navigating to the gPanel API developer portal

gPanel API 11

2. Click on Sign In on the top right

3. Click the Create an account link

4. Follow prompts

gPanel API 19

5. You will receive an email to the provided email address to validate your email address

gPanel API 20

Once your account is validated, you will then have to wait for the Promevo Team to activate your account.  Until your account has been activated you will receive the following error on login attempts. 

gPanel API 21

Step 2 - Register apps

To register an app:

Sign into your developer account on the gPanel API developer portal

gPanel API 11

2. Select Apps from the user drop-down.

3. Click + New App to create a new app

4. Enter a name and description for the app in the New App dialog

5. Select the Enable button for the APIs applicable to the app

gPanel API 23

6. Click Save

7. You will now see the API Key for the newly created app

gPanel API 22

Step 3 - Register API key in gPanel

  1. Sign into the gPanel API developer portal

  2. Select Apps from the drop-down

  3. Select the app you wish to register in gPanel

  4. Copy the API key under the API Keys section

  5. Navigate to gPanel

  6. Navigate to API Settings

Click on the + in the header

Screenshot 2023-11-06 at 7.12.13 PM

8. Follow the prompts

9. Click Save

Step 4 - Make an API call

  1. Navigate to the gPanel API developer portal

  2. Click on the APIs box to view the API documentation

    gPanel API 11

3. Click on the API you wish to call

Screenshot 2023-11-06 at 7.12.22 PM

4. Capture the URL of the API you wish to call

gPanel API 13

5. Now form your API endpoint by concatenating your api as a query parameter at the end of your endpoint, like so: 

https://api.gpanel.promevo.com/v1/applog?apikey=INSERT INFO HERE

Now let's use our endpoint to make an api request via HTTP GET. Easiest way is to paste it into a browser, like so: 

gPanel API 14

Summary

Let’s examine our request and point out a few things.  First, if we visit our api documentation on the developer portal, we’ll see that our api request can take parameters.

gPanel API 15

Specifically, we could pass a cursor, a startTime, or endTime.  We didn’t pass either startTime or endTime in our request, which means we want all logs.

Let’s examine this json response, and take note of a few things.

gPanel API 16.2

gPanel API 17

We’ll notice that the response contains a nextPageToken element. Because our request could potentially return thousands of logs, they do not all get returned in a single response.  This api returns a paged response.  This means that we get a subset of the response (200 items in this instance).  In order to get the rest, we use the nextPageToken to make subsequent calls.

If our next response contains a nextPageToken, then we use that one to make another call.  We continue making requests until the response no longer contains a nextPageToken.