Cloud api reference?

🚧 Developers
1

Just a quick question -

I've just bought a Hubitat and connected a couple of devices. So far so good. My initial interest is in controlling some Zigbee outlets from an Android app. However, I can't find a set of API docs for the cloud REST api.

Is there a way I can generate some kind of access token? And/or how do I discover my hub ID? Is there a swagger page (or other API reference document somewhere)

Cheers, Mark

2

Install the Maker API app. It will allow you to select the devices you want to expose to the api and also provide with sample url's (including your tokens).

For documentation see here

image
image.png1282×761 54.5 KB

The direct link for the maker api app is:
https://docs.hubitat.com/index.php?title=Maker_API

3

Ah. That's great - thanks.

Regarding the Dev. Documentation in general - is there an overview of the app development somewhere - that Documentation link is a reference for the Groovy API - are there some walk-through docs anywhere (I can likely work it out but if there's a quick start dock somewhere that would help).

Thanks again, Mark

4

Unfortunately there isn't much there in terms of Groovy how To's. I learnt most of what I know from reading the smartthings documentation. Their old API was almost identical to hubitat's but they have been moving to a new API so I can't say how relevant those docs would be now. Might be worth a look anyway.
docs.smartthings.com

2 Likes
5

You realize that you can control these from our mobile app running on your Android device, right?

But if you want to do it in some other app you have coded, use Maker API. It will show you the specific endpoints you need with oauth tokens and everything -- just fill in the blanks.

If you need a device id in Hubitat, it shows up in the url when you access the device on the Devices page, like this:

http://192.168.0.71/device/edit/7815

For that device, its id is 7815.

1 Like
6

@bravenel Yes, I know about your app. I want to make a dedicated app for my requirements. Is the app closed-source? I'm pretty sure the Maker API will suffice.

An OpenAPI (swagger) spec would be more than useful... :slight_smile: