Introduction
Before starting any implementation, it is important to be aware of Netatmo guidelines. These guidelines are divided into three different thematics : the developer guidelines, the marketing guideline and the legal one.
Developer guidelines are going through major tips, tricks and advices that you will need to build your app. It will help you understand what to start with and how to do it.
Developers
If you have not created your application yet, you can do it right now. Log in and create your first application.
Ready ? You now have retrieved you client_id and your client_secret. Never share your client_secret to anyone, it is the key that allows Netatmo to securely identify your app. You can now start with the authentification part.
Authentication
Because privacy and security is one of our major focus, we ask you to follow the OAuth 2.0 protocol which is the industry-standard protocol for authorization and the most secure authorization protocol.
Learn how to authorize your users and get the token necessary to make API calls, get to know more about OAuth 2, and the different grant types available at Netatmo Connect in the Authentication guide
Last but not least, never store users credentials. This is strictly unauthorized. You can only store the pair access_token/refresh_token.
Scopes
Your app isn’t automatically granted a scope, users give you scope permission while authorizing your app. During the OAuth process, you will be able to request the scopes you need for your user and your token will be limited to those scopes. Default scope is read_station. We recommend that you only use the scopes you needs.
Due to its sensitive nature, the "access" scopes for cameras are only given on a per app basis after our teams have reviewed it. Read more and request on "My apps".
Can I access data directly from the devices?
It is not possible for the moment. The only way to access the data and the devices is via the Netatmo Cloud.
Rate limits
Limits grow accordingly to the number of users using your app and should never be an issue. On the other hand, you should also try optimizing your project so it does less calls.
When using Netatmo Smart Home API, you can reach two kinds of limits:
Application limit: The application limit is the global limitation of (all call/request of) your app.
User limit: The user limit is here to prevent one user from disabling your app ability to call Netatmo APIs.
Application limits
If you have less than 100 users:
200 requests every 10 seconds
2000 requests every hour
If you have more than 100 users:
(2 * number of users) requests every 10 seconds
(20 * number of users) requests every hour
Per user limits
50 requests every 10 seconds
500 requests every hour
Marketing
Branding
When defining the graphic identity of your project, you are more than welcome to use Netatmo brand materials to highlight the use of Netatmo APIs. It's always nice to give credit but it's sometimes complicated to know what you can actually do with a brand and its logo. These branding guidelines, are here to help you! You will find below how to use Netatmo brand and visual assets in the best possible way.
Naming
Please choose a name for your app which is not confusing with the Netatmo brand. For example, avoid using Netatmo-Yourbrand, Net-Yourbrand-atmo, etc...
In addition, for clarity purposes, create a logo which is clearly different and not using any part of the Netatmo logo.
Brand use
You are very welcome to use the Netatmo logo to highlight you're using Netatmo APIs, but please keep in mind your brand should be more prominent than the Netatmo brand name or logo. The visual guidelines below will help you.
Commercial use
You can use Netatmo Smart Home and Enterprise programs for commercial use as detailed in the Terms and Conditions. If you are using Netatmo Weather API for commercial purposes, please reach out to let Netatmo partnerships know about it: partnerships@netatmo.com
Wording
Please do not use any confusing wording which may imply that you signed a specific partnership, endorsement, affiliation etc... with Netatmo.
Branding kit
You can use, under certain conditions, the Netatmo logo and product images to illustrate you're using Netatmo Connect. Feel free to use the kit below where you will find Netatmo logo and pictures.
Legal
Using Netatmo Connect APIs you will have access to very sensitive information. This is particularly true if your app accesses our Cameras (live stream or videos). Make sure you respect user's privacy and have a strong privacy policy.
By creating an app, you have to agree to the Terms and Conditions. Any app that wouldn't be compliant with our policy will be deactivated.
You can use Netatmo API for commercial use as detailed in the Terms and Conditions. If you are using Netatmo API for commercial purposes, please reach out to let Netatmo partnerships know about it: partnerships@netatmo.com