IoT controller with a REST API

Most controllers in this category make you choose: their platform, or raw data shipped somewhere you have to build. Genesis comes with OmniCloud, and with a REST API that covers what the dashboard covers, so your own system can be the front end from the first day.

What the API covers

Devices and port configuration

List devices, read their state, and set what each port reads and how often, the same settings the dashboard changes.

Readings

Pull readings by device, sensor and time range into your own database, reports or customer portal.

Control and permissions

Fire outputs, manage users and accounts, and share devices between accounts, with tokens scoped to exactly what an integration needs.

How access works

StyleREST over HTTPS
AuthenticationBearer tokens, scoped to a subset of the owner's permissions
Token lifecycleExpiry and revocation
ExportsExcel files, from the dashboard and the API

Getting started

Create a scoped token

Give the integration only the permissions it needs, for example read access to one account's readings.

Pull, then decide on push

Start by polling readings on a schedule that matches the device reporting interval. Ask us about the integration you have in mind before building around push delivery.

Worth knowing

Readings arrive at the reporting interval

The API serves what the devices have sent. A battery unit transmitting once a day has its readings in the cloud once a day.

Start from the integration

Tell us what you are connecting and we walk you through the endpoints it needs, before you write the first line against them.

Related

Frequently asked questions

Do we have to use the dashboard at all?

No. The API covers what the dashboard covers, so your own system can be the only front end your users see.

Can a token be limited to one customer's data?

Yes. A token carries a subset of its owner's permissions, so it can be scoped to one account and read only.

Can we send commands through the API?

Yes. The control commands that fire an output are part of it.

Tell us what needs reading

The sensors, how many points, where they sit, and whether there is power and coverage. We come back with whether the ports cover it and what the installation looks like.

Talk to us →