LaggAt / hacs-govee

A HACS repository for Govee light integration
MIT License
262 stars 60 forks source link

Govee API update #65

Open pbavinck opened 2 years ago

pbavinck commented 2 years ago

I received the following email from Govee and am wondering if this change impacts the current integration Govee integration in Home Assistant and whether a change in code is required.

Dear User,Thank you for choosing Govee and for your constant support! For 2022, we have some important updates for our Govee API to inform you about.1. “Govee API” has been officially renamed to the more standard “Govee Developer API”.2. We have updated the Terms of Service for the Govee Developer API to better protect the legitimate rights and interests of both parties. Terms of Service documentation can be accessed here.3. Due to the limited resources of the API server, the flow of some high-frequency API calls will be limited in order to make the API server more stable and serve more users.If your current usage scenario does not call the API frequently, your applications will not be affected.If your current usage scenario calls the API frequently, your application might be affected and may not function properly. Therefore, you will need to modify your applications to call the API less frequently. Specific rules related to this are listed in the latest API reference document.The limit on API call frequency will be implemented started May 5, 2022. We hope you can complete any needed modification of your API applications before this date so your applications will continue to run normally.If you have any question, please contact us via api-support@govee.com.Best Regards,Govee Team
--

Dear User,

Thank you for choosing Govee and for your constant support!

For 2022, we have some important updates for our Govee API to inform you about.

1. “Govee API” has been officially renamed to the more standard “Govee Developer API”.

2. We have updated the Terms of Service for the Govee Developer API to better protect the legitimate rights and interests of both parties. Terms of Service documentation can be accessed [here.](https://click.mlsend.com/link/c/YT0xOTE4ODc5NTY5MzE4Nzc5NTIzJmM9ajVkNSZlPTAmYj05NTE0Mjk0NDAmZD1nNGkzejZ1.K1rxWT1JaLepWnRhAS5EZaFEDjpJjzrOg1G7kuxb4jc)

3. Due to the limited resources of the API server, the flow of some high-frequency API calls will be limited in order to make the API server more stable and serve more users.

If your current usage scenario does not call the API frequently, your applications will not be affected.
If your current usage scenario calls the API frequently, your application might be affected and may not function properly. Therefore, you will need to modify your applications to call the API less frequently. Specific rules related to this are listed in the latest [API reference document](https://click.mlsend.com/link/c/YT0xOTE4ODc5NTY5MzE4Nzc5NTIzJmM9ajVkNSZlPTAmYj05NTE0Mjk0NTAmZD1zOXU1YjV0.Ae_DgWqEOXCYlCcWNm9dMvdowRAipnVW__jr38jh2DE).
The limit on API call frequency will be implemented started May 5, 2022. We hope you can complete any needed modification of your API applications before this date so your applications will continue to run normally.
If you have any question, please contact us via [api-support@govee.com.](mailto:api-support@govee.com.)[](https://click.mlsend.com/link/c/YT0xOTE4ODc5NTY5MzE4Nzc5NTIzJmM9ajVkNSZlPTAmYj05NTE0Mjk0NjEmZD13NWE3bjNv.pyqdVGkaDb_xDojHKAQGJ2StpKqowYe5nSe4ErSQegw)

Best Regards,

Govee Team
LaggAt commented 2 years ago

Hi, thanks.

I don't see what needs to change, but bigger installations should have less issues with rate limit. It seems they listened to users and started to use rate limits per device.

I leave the item open to implement the exact limit rules later.

smarthomelawyer commented 2 years ago

FYI, according to the Homebridge counterpart, The new limits are:

A total of 10000 request per day per user, and 10 requests per minute per device, (get state, update state each count as one request)

https://github.com/bwp91/homebridge-govee/releases/tag/v4.30.2

skullbunnygalaxy commented 9 months ago

This may be useful https://govee.readme.io/reference/rate-limiting