API reference

The Realer API is organized around REST, with a primary focus on control devices. Our API has predictable resource-oriented URLs, accepts JSON-encoded and form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

You can use the Realer API in production mode with your control devices, which affects your live data to interact with the physical world. Control devices authenticate with OAuth 2.0 Client Credentials Grant at POST /oauth/token. Protected device API requests use Authorization: Bearer <access_token> on the canonical iot/v1 endpoints.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Disclaimer

When using the Realer API as a control device developer, you are subject to developer responsibility.