24 lines
1.2 KiB
Markdown
24 lines
1.2 KiB
Markdown
---
|
|
title: API Getting Started
|
|
publish: true
|
|
---
|
|
This document will explain how to get started with the Sentri API.
|
|
## Requirements
|
|
To connect to the Sentri API, you will need the following:
|
|
- A basic understanding of how APIs work, along with some programming or scripting experience.
|
|
- The Sentri base URL.
|
|
- An API bearer token.
|
|
- Network access from the devices making API requests to the Sentri service on port 443.
|
|
## Creating a authentication bearer token
|
|
Make sure you have the `user-apitoken-self` read/write permission, as this allows you to create an authentication bearer token.
|
|
|
|
Once logged in, go to your profile at `/userprofile` and click Generate API Token.
|
|
A token will be displayed, as shown below. This token will be used as the authentication bearer token, so make sure to copy it as it will only be shown once.
|
|
```
|
|
c8aaf11d-e10e-11f0-9b16-00155d00153f.83f0383262a4875f6c6d4bb5aa8577818ca7f71cb2ba80b9e9b9cb43f5b86831
|
|
```
|
|
## Trouble shooting
|
|
When you encounter a problem with the API, you will most likely receive an HTTP status code in the response. This code can help indicate the nature of the issue.
|
|
### Response codes
|
|
These are some of the response codes you may receive when making a call to the API:
|