🚀Quick Start

In order to make your first request, you must follow the steps below:

• Creating an Account

• Creating an API User

• Authorization

• First Request

Creating an Account

Firstly, you need to open an account on Perculus. If you have an account, you can skip this step.

We will name the ‘Account Title’ field in your account settings as a domain in the document, and it is essential to note this field as we will use it when sending requests.

Creating API User

To use the Perculus API, you need to create an API user. You can follow the steps below for this process;

1. Login to your Perculus account from here

1. After logging in, click on the ‘New User’ button in the ‘Users’ section to open the new user creation screen.

   

At this stage, we will use the information you will write in the email and password fields in the user creation form when sending requests to the API. Therefore, remember that this user should not be deleted.

Authorization

Please follow steps that is in Authorization section.

First Request 🚀

We have outlined all the steps necessary to make your first request to PerculusAPI above. You are now ready to make your first request.

We will use the CURL method to make a request. We will illustrate this with the /session endpoint where you can list all your sessions on the system.

Requirements

• Domain

• Access Token

For our example service, session list, you can now see the CURL structure:

curl --location 'https://<DOMAIN>/xapi/session' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'

You can list all your sessions in the response when you send the sample request above.

It's that easy to send requests in Perculus. 🚀