Inquiry regarding Homey Web API (HTTP) and Socket.io limits for large-scale deployment (100+ Homey Pros)

Questions & Help
1

Dear Homey Community and Athom Team,

We are currently developing a monitoring solution designed to manage and collect operational data from a large-scale deployment of over 100 Homey Pro units.

To ensure the stability of our integration as we scale, we would like to clarify the specific rate limits and quotas for both HTTP and Socket.io communications:

  • Web API (HTTP): Are there specific rate limits or throttling policies for standard RESTful API calls? We are interested in knowing if limits are applied per API Key or per Homey Pro unit.

  • Real-time Data (Socket.i0): Since our system will maintain multiple concurrent connections to monitor devices in real-time, are there any restrictions on the number of concurrent Socket.i0 connections or the frequency of emitted events via the Homey Cloud?

  • Scalability & Quotas: If such limits exist, is there a formal process or contact point to discuss adjusting these quotas to accommodate our specific use case?

Official documentation or guidance on these constraints would be invaluable for our system architecture.

Thank you for your time and assistance.

Best regards,

1 Like
2

What’s the reason behind your question? Just using Homey aop and its cloud connection or using an own client (with client ID/secret)?

This is my experience as user of WebAPI (via REST/Athom cloud):

When using oAuth (with your client ID), you are authenticating against Athom server. Then you have to select one Homey from your account. Then you request an (bearer) token from this Homey.

So a http connection is done only from your client to one Homey (via cloud URL where the HomeyID is included). I would say, a rate limit would only affect this single connection. But I haven’t seen rate limits yet for a normal use.

3

I think you should ask Athom. You can contact Athom here:

The web API docs indeed don’t mention anything about rate limits. I think SocketIO connections are unlimited.

If there are rate limits, they are likely per Homey. The cloud URL (cloudid.connect.athom.com) is simply a proxy service that proxies all requests to your Homey, so that’s likely unlimited. However, API calls to the auth endpoints might get rate limited.