Base URL: https://api.y-home.cc/v1 · Auth: Bearer token (OAuth 2.0 client credentials).
GET /v1/sites/{site_id}/devices
Authorization: Bearer <access_token>
{
"data": [
{"id":"dev_8f2a","type":"light","brand":"philips","online":true},
{"id":"dev_1c93","type":"lock","brand":"august","online":true}
],
"next_cursor": null
}
POST /v1/devices/{device_id}/state
{"brightness": 80, "color_temp": 3000}
200 OK {"id":"dev_8f2a","state":{"brightness":80},"updated_at":"2026-01-14T09:22:11Z"}
| Plan | Requests / min | Burst |
|---|---|---|
| Developer | 60 | 120 |
| Business | 600 | 1200 |
| Enterprise | Custom | Custom |
Webhooks, pagination and error codes are covered in the full developer portal. Contact support@y-home.cc for sandbox credentials.