# External Device

This requires a [RAPT Subscription](https://docs.rapt.io/my-account/subscriptions)

The URL for the Api is: <https://api.rapt.io>

Opening the api address in your browser will load a Swagger interface which details the available endpoints on the Api, including parameters and response models where applicable.

The Api requires a bearer token (see obtaining bearer tokens) to be included within an Authorization header for all requests.

### API Secrets <a href="#user-content-api-secrets" id="user-content-api-secrets"></a>

Before you can obtain a bearer token, you will require an Api Secret. Login to the RAPT App and navigate to "My Account / Api Secrets". From here you can create an Api Secret. Please note that once a secret has been created, it is hashed and unrecoverable. You will need to record the secret when it is shown to you, as you will **not be able to see it again from the RAPT App**.

### API Samples

* [How to obtain a bearer token](https://gitlab.com/rapt.io/public/-/wikis/RAPT%20API/obtaining-bearer-tokens)
* [Submitting telemetry for non-RAPT devices](https://gitlab.com/rapt.io/public/-/wikis/RAPT%20API/external-devices)

### Support and API Use and Misuse

* Access to the Api is unsupported. This means you will not be able to get assistance from KegLand directly. I may respond to some questions posted here on Facebook, but I am not going to teach you how to write code, troubleshoot your code, or write code for you
* If your use of the Api causes problems with your Rapt account or devices, this is on you. We track all Api requests, so if you destroy a device through misuse of the Api, it will void your warranty and I'm sure you will have a hard time convincing KegLand to replace it
* If your use of the Api causes problems with other Rapt users, depending on the severity of the problem, you will be given a warning and/or your access to the Api will be revoked. Extreme abuse of the Api will result in a permanent ban from the Rapt ecosystem, meaning the devices you have purchased will be all but useless
* The Api (endpoints, parameters, response models etc.) is subject to change without notice
