Want to skip my rants? Go directly to the API documentation
Before we start - a big FU to Anova! After many years of people in the community asking for an open API, or some way, any way, of interacting with their products in an open way, they still will not provide that. In fact, they repeatedly took active action to prevent people from doing this (changing authentication mechanisms, undocumented API changes, or telling people that "they are working on a public API" and instead implementing certificate pinning, etc).
In fact, no - let me rephrase this. This is not directed to all the people at Anova. I am sure they have plenty of good people, working to create good products. And they do make quality products to prove that. This is just for the few people in charge who just don't understand that allowing customers to actually interact with their products in an open way would in no way hurt the company or their market. In fact, it would actually be beneficial for everyone, making possible new use cases.
Most people asking for an API are (just like me) huge fans of Anova and their products, looking for a way to actually extend the functionality of those products. Too bad Anova doesn't seem to understand that...
Rant over, back to the docs.
Warning
This project is in no way affiliated with Anova. Anything you find here is just based on whatever public information I was able to gather. And if the past is any guide, things can (and will) change based on Anova's whims.
Use this at your own risk.
Some useful links I used when putting this together:
- API decoding by mcolyer. Unfortunately, this is for the v1 API, which was deprecated by Anova in August 2022
- Anova oven forwarder by huangyq23 . The project that got me started in the right direction for the v2 API. Also, a great project for anyone looking to collect data from the oven, and even get a nice Grafana dashboard with the various oven parameters. Unfortunately, I was unable to get in touch with the creator - he/she does not respond to issues, and the discord invite in the repo does not work :(
- The discussion that got this project started. Hopefully, in the future, the information I post here will help someone write an actual Home Assistant integration for the oven
- The request for a public API. Maybe one day this will be available, and my repo will become obsolete. Just don't hold your breath...
The detailed documentation is here
A Postman Workspace is available here. Follow the directions for forking it to a private workspace so you do not expose your tokens. Thanks and credit go to nhorvath .