Files
Sentri-docs/API/Getting Started.md
Marco Mooij | DigiState a160d31953 v1.2 initial commit
2026-05-13 09:56:43 +02:00

1.2 KiB

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: