1. Support
  2. Knowledge base
  3. Uptrends' API
  4. Authentication (version 4)

Authentication (version 4)

We’re changing our user interface. Some info may not yet be up to date. Please check From classic to new UI.

Each API method requires authentication through an API account, so you’ll first need to create one. This API account is based on your Uptrends account, but is not the same. The advantage of having separate accounts is that you use the API credentials within e.g. scripts and don’t have to disclose your Uptrends account credentials.

The POST method of the /Register endpoint lets you create a new API account. In the steps described, we’ll use the Swagger environment to access the API directly. The API account we’re about to create will not expire, so you will only need to do this once.

Registering an API account

  1. Go to the Swagger page, and locate and expand the POST /Register method.

  2. Click the Try it out button to start creating an API account.

  3. Click on the Execute button.

  4. Your browser will now ask for your Uptrends operator login credentials. Fill in the e-mail address and password that you normally use to access Uptrends and click OK.

  5. After the login credentials of your Uptrends account were verified, the Response body contains values for UserName and Password.

  "UserName": "usernamehere",
  "Password": "passwordhere",
  "AccountId": "123456",
  "OperatorName": "Your name",
  "status": "OK"

These are the credentials of your new API account.

  1. Click the Download button within the Response body to save these credentials and keep them in a safe place. Use them as authentication for all other API calls.
Note: The API account will not expire. However, if you lose your credentials they cannot be recovered. You will have to create a new API account.

Usage of your API account

Now that you have an API account you can start using it. If you are using Swagger, you provide the credentials in a dialog. In software like cURL or Postman you provide them as headers and the necessary encoding is taken care of. If you are using your own scripts, you first have to encode your credentials, see the section Basic authentication.

Note: Remember that this API account is linked to your Uptrends operator account, so it will have the same privileges you have in your Uptrends account.

Swagger environment

If you are executing API methods in the Swagger environment, a Sign in (referring to api.uptrends.com) window will pop up where you have to enter your API account Username and Password.

Basic authentication

The account credentials always have to be encoded using the basic authentication scheme and provided to the API as particular header.

Software like Postman, cURL, etc. will take care of encoding the credentials and providing them correctly. If you are writing your own script you have to provide this header to the API call:

Authorization: Basic {{encoded credentials}}

The credentials have to be base64 encoded. To create the header, follow these steps:

  1. Define a string with the syntax username:password, replacing the username and password with your credentials. Do not add any spaces.

  2. The string username:password has to be base64 encoded. The encoding functionality may be included in your software or scripting language or you use a tool like https://www.base64encode.org.

  3. Once you have the encoded string, create and use a header Authorization: Basic {{encoded credentials}}, where the encoded credentials is the base64 encoded string from the step before.

By using the Uptrends website, you consent to the use of cookies in accordance with our Cookie Policy.