JouloDocs
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.

POST
/public-chargers/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.

Lengthlength <= 64
minutes?integer

How long Joulo watches.

Default180
Range30 <= value <= 720
radius_m?integer

Also count a free laadpunt nearby within this distance.

Default0
Value in0 | 500 | 1000

Response 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