API Tokens
API access tokens are the credentials needed to access the Astrocast API.
An access token is used in two scenarios:
- To pull data from the Astrocast API.
- To authenticate your Astronode Wi-Fi DevKit while sending messages.
tip
For security reasons, we recommend you to create a separate API access token for each application. If one of your tokens is compromised, you can always revoke that specific access token.
Create an access token
In order to create a new access token,
- Go to the Astrocast Portal.
- In the bottom left corner, click on
⚙️ Settings
. - Click on
Access Tokens
. - Click on
➕ create new access token
. - Enter the access token's
Name
, set anExpiration date
and assign aRole
. - Click on
Create
. 🗒️
Copy the access token and store it in a safe place.
caution
You are responsible of storing your access token in a secure location. Astrocast cannot retrieve an access token if you lose one.
Edit an access token
In order to edit the parameters of an access token,
- Go to the Astrocast Portal.
- In the bottom left corner, click on
⚙️ Settings
. - Click on
Access Tokens
. - Click on
🖊️
to edit an access token. - Update the access token
Name
, theExpiration date
and/or theRole
. - Click on
Update
.
Delete an access token
When you prefer to delete an access token,
- Go to the Astrocast Portal.
- In the bottom left corner, click on
⚙️ Settings
. - Click on
Access Tokens
. - Click on
🗑️
to delete an access token. - Confirm.
Role description
Role Name | Description |
---|---|
Owner | Grants full access to manage all resources, including the ability to assign roles. |
Contributor | Grants full access to manage all resources, but does not allow you to assign roles. |
Reader | View all resources, but does not allow you to make any changes. |
Wi-Fi DevKit | Allows to send messages and retrieve unicast commands. |
Device Engineer | Grants full access to devices including control commands. |
note
Go to the Astrocast Portal / Role to find full roles description.