Lap-Platform Netatmo
API version: 1.1.5
Auth
OAuth2 | OAuth2
Base URL
Setup
- Configure auth: OAuth2 | OAuth2
- GET /getpublicdata -- verify access
- POST /syncschedule -- create first syncschedule
Endpoints
22 endpoints across 22 groups. See references/api-spec.lap for full details.
getpublicdata
| Method | Path | Description |
|---|---|---|
| GET | /getpublicdata | Retrieves publicly shared weather data from Outdoor Modules within a predefined area. |
getuser
| Method | Path | Description |
|---|---|---|
| GET | /getuser | The method getuser returns information about a user such as prefered language, prefered units, and list of devices. |
devicelist
| Method | Path | Description |
|---|---|---|
| GET | /devicelist | The method devicelist returns the list of devices owned by the user, and their modules. |
getmeasure
| Method | Path | Description |
|---|---|---|
| GET | /getmeasure | The method getmeasure returns the measurements of a device or a module. |
getthermostatsdata
| Method | Path | Description |
|---|---|---|
| GET | /getthermostatsdata | The method getthermostatsdata returns information about user's thermostats such as their last measurements. |
getstationsdata
| Method | Path | Description |
|---|---|---|
| GET | /getstationsdata | The method getstationsdata Returns data from a user's Weather Stations (measures and device specific data). |
gethomecoachsdata
| Method | Path | Description |
|---|---|---|
| GET | /gethomecoachsdata | The method gethomecoachsdata Returns data from a user Healthy Home Coach Station (measures and device specific data). |
getthermstate
| Method | Path | Description |
|---|---|---|
| GET | /getthermstate | The method getthermstate returns the last Thermostat measurements, its current weekly schedule, and, if present, its current manual temperature setpoint. |
syncschedule
| Method | Path | Description |
|---|---|---|
| POST | /syncschedule | The method syncschedule changes the Thermostat weekly schedule. |
setthermpoint
| Method | Path | Description |
|---|---|---|
| POST | /setthermpoint | The method setthermpoint changes the Thermostat manual temperature setpoint. |
switchschedule
| Method | Path | Description |
|---|---|---|
| POST | /switchschedule | The method switchschedule switches the Thermostat's schedule to another existing schedule. |
createnewschedule
| Method | Path | Description |
|---|---|---|
| POST | /createnewschedule | The method createnewschedule creates a new schedule stored in the backup list. |
partnerdevices
| Method | Path | Description |
|---|---|---|
| GET | /partnerdevices | The method partnerdevices returns the list of device_id to which your partner application has access to. |
gethomedata
| Method | Path | Description |
|---|---|---|
| GET | /gethomedata | Returns information about users homes and cameras. |
getcamerapicture
| Method | Path | Description |
|---|---|---|
| GET | /getcamerapicture | Returns the snapshot associated to an event. |
geteventsuntil
| Method | Path | Description |
|---|---|---|
| GET | /geteventsuntil | Returns the snapshot associated to an event. |
getlasteventof
| Method | Path | Description |
|---|---|---|
| GET | /getlasteventof | Returns most recent events. |
getnextevents
| Method | Path | Description |
|---|---|---|
| GET | /getnextevents | Returns previous events. |
setpersonsaway
| Method | Path | Description |
|---|---|---|
| POST | /setpersonsaway | Sets a person as 'Away' or the Home as 'Empty'. The event will be added to the user’s timeline. |
setpersonshome
| Method | Path | Description |
|---|---|---|
| POST | /setpersonshome | Sets a person as 'At home'. |
addwebhook
| Method | Path | Description |
|---|---|---|
| GET | /addwebhook | Links a callback url to a user. |
dropwebhook
| Method | Path | Description |
|---|---|---|
| GET | /dropwebhook | Dissociates a webhook from a user. |
Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all getpublicdata?" -> GET /getpublicdata
- "List all getuser?" -> GET /getuser
- "List all devicelist?" -> GET /devicelist
- "List all getmeasure?" -> GET /getmeasure
- "List all getthermostatsdata?" -> GET /getthermostatsdata
- "List all getstationsdata?" -> GET /getstationsdata
- "List all gethomecoachsdata?" -> GET /gethomecoachsdata
- "List all getthermstate?" -> GET /getthermstate
- "Create a syncschedule?" -> POST /syncschedule
- "Create a setthermpoint?" -> POST /setthermpoint
- "Create a switchschedule?" -> POST /switchschedule
- "Create a createnewschedule?" -> POST /createnewschedule
- "List all partnerdevices?" -> GET /partnerdevices
- "List all gethomedata?" -> GET /gethomedata
- "List all getcamerapicture?" -> GET /getcamerapicture
- "List all geteventsuntil?" -> GET /geteventsuntil
- "List all getlasteventof?" -> GET /getlasteventof
- "List all getnextevents?" -> GET /getnextevents
- "Create a setpersonsaway?" -> POST /setpersonsaway
- "Create a setpersonshome?" -> POST /setpersonshome
- "List all addwebhook?" -> GET /addwebhook
- "List all dropwebhook?" -> GET /dropwebhook
- "How to authenticate?" -> See Auth section
Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object
References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas
Generated from the official API spec by LAP