Uitbreidingen van de API

Zoals u van ons gewend ben, is er ook met de aankomende release verschillende wijzigingen en toevoegingen aan de BeNext-API doorgevoerd. De volledige documentatie voor deze API beschikbaar op http://api.benext.eu/documentation/documentation.pdf.

Ondersteuning voor HMAC-codes

Voor sommige use-cases is het noodzakelijk om informatie te delen met een derde partij zoals bv. IFTTT. Omdat het onveilig (en niet toegestaan) is om je API-key te delen maakt BeNext het met de aankomende release mogelijk om HMAC-codes te genereren voor individuele accounts. Deze HMAC-code kunt u voor een enkele gebruiker activeren, maar blijft gekoppeld aan de API-key. Dat houdt in dat de HMAC-code onbruikbaar gemaakt kan worden door de API-key uit te zetten. Hierdoor behoudt u als eigenaar van de zeggenschap over uw data.

Scenes activeren met de API

We zijn bezig geweest met de implementatie van een veel gevraagd iets: De mogelijkheid om scenes te activeren via de API! Gecombineerd met de nieuw toegevoegde ondersteuning voor HMAC maakt dit het mogelijk om bijvoorbeeld scenes aan te sturen via IFTTT – met alle mogelijkheden wat dit zich meebrengt.

Nieuwe filteropties

Er zijn verschillende nieuwe filteropties toegevoegd aan de API die het nog makkelijker maken om de resources te vinden die u nodig heeft.

Account: account_search, zoeken op gebruikersnaam, firstname, lastname en email
Failure: status_str, filter op 1 of meer van de drie beschikbare statusen
Address: address_search, zoeken op adres, postcode, stad of land

Nieuwe Address resource

Er is een gloednieuwe resource beschikbaar! Als er voor een gebruiker een adres ingesteld is kunt u deze inzien met behulp van de nieuwe address-resource. Deze bevat informatie over het adres, postcode, woonplaats en land.

Correcties

Hoewel het niet vaak voorkomt, maakt iedereen wel eens een spellingfoutje. Deze release heeft een wijziging die niet backwards-compatible is. Bij de failuretype resource is het veld resource_type aangepast naar het correcte resourcetype. Mocht dit problemen opleveren voor uw applicatie, laat het dan weten. We zullen kijken hoe we u kunnen ondersteunen in het doorvoeren van de noodzakelijke wijzigingen.

Diversen

• De achterliggende code voor energyassetproperties is verbeterd waardoor het opvragen efficiënter gebeurt als er veel properties beschikbaar zijn.
• De account-resource bevat nu informatie over de door de gebruiker gewenste taal.