Getting started
The Connect IoT API is a RESTful API that allows you to interact with the Connect IoT platform. The Swagger documentation is available at https://api.connect-iot.eu/docs.
Authentication
Authentication is done using the Authorization header or via the X-API-Key header. For short-term authentication we recommend using the Authorization header. The X-API-Key token should be used for long-term applications.
Authorization header
Support for the Authorization header using bearer tokens is planned and will be available soon. This method is intended for short-term access, such as interactive sessions, developer tools, or applications with frequently refreshed tokens.
Once available, you will authenticate by including a bearer token in the Authorization header of your requests.
Further instructions and token generation methods will be documented here once released.
X-API-Key header
The X-API-Key header is used for long-term authentication, typically for server-to-server integrations, background jobs, or embedded systems that require stable access credentials.
To use this method, include your API key in the X-API-Key header of your request. API keys are currently issued manually by the Connect IoT team. If you need access, please contact us at info@connect-iot.nl with a brief description of your use case.
In the near future, users will be able to generate and manage their own API keys directly from the Connect IoT app. Until then, all keys are provided manually.
Be sure to store your API key securely and avoid exposing it in client-side environments such as browsers or mobile apps.