Api referenceEnergy
Mail me when a laadpunt at a public charger comes free
Turns on a mail to the address of your Joulo account when a laadpunt at this public charging location comes free. With radius_m a free laadpunt at the nearest 30 locations of the same kind (fast or not) within that distance counts too. Joulo reads the NDW status every minute and mails once; then the watch ends. At most three watches run per account. Asking again for the same location returns the watch that runs (already_running). Requires the alerts:write scope. It writes nothing but the watch.
AuthorizationBearer <token>
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
party_idstring
The operator's party id, from GET /public-chargers.
Match
^[A-Za-z0-9]{2,3}$location_idstring
The location id, from GET /public-chargers.
Length
length <= 64minutes?integer
How long Joulo watches.
Default
180Range
30 <= value <= 720radius_m?integer
Also count a free laadpunt nearby within this distance.
Default
0Value in
0 | 500 | 1000Response Body
curl -X POST "https://api.joulo.nl/functions/v1/api/public-chargers/watch" \ -H "Content-Type: application/json" \ -d '{ "party_id": "GFX", "location_id": "ECBC966C-B948-40E2-A3FB-5F154E34EAD0", "minutes": 180, "radius_m": 500 }'{
"watching": true,
"party_id": "string",
"location_id": "string",
"expires_at": "2019-08-24T14:15:22Z",
"radius_m": 0,
"already_running": true,
"map_url": "http://example.com"
}Empty
Empty
Empty