Try the API with Postman
Learn how to try the Onna API using Postman
We recommend using Postman (opens new window) to get an overview about the API.
# Requirements
- Postman
- Onna account (opens new window)
# Set up
- Download and install Postman.
- Sign up for an Onna account (opens new window) and follow the instructions.
- Download
onna-api-example.json
(opens new window) andenvironment.json
(opens new window) files from our repository.
# Configuration
# Disable telemetry
You can disable all tracking by setting Send anonymous usage data to Postman to OFF in the settings window.
# Get authentication token
Get your token from your browser:
Info
The tokens used in the examples below are customized placeholder tokens.
# Values
Postman allows to use a configurable environment using a set of key-value pairs. Creating commonly used variables that can be referenced by multiple requests in a collection.
More documentation on the Postman environment can be found in the Postman docs (opens new window).
It is important that you edit and replace some of these variables with your own values.
Access the edit dialog by clicking the gray eye button next to the environment dropdown (highlighted in blue below):
Select Edit (highlighted in blue below):
Replace the following values with your own initial one:
user
Username you provided during self-registration. For exampleusername@email.io
.container
The name of the database attached to your account. Onna naming convention is to use the account name you provided during the self-registration process.account
May be the same value as container.password
Password of your account.token
Your JWT token
scope
, container
, and account
may be the same value.
You should have obtained these when creating your own Onna account (opens new window).
You can find more information in our glossary.