API-sleutels voor je eigen integraties
Maak een API-sleutel aan zodat je domotica of een rekenblad je laadsessies bij Veton kan uitlezen.
Waarvoor een API-sleutel dient
Met een API-sleutel kan een programma van jou, bijvoorbeeld Home Assistant of een script dat een rekenblad vult, je laadsessies en de status van je laadpaal bij Veton uitlezen. De sleutel kan alleen bij wat je zelf al op het dashboard ziet, en een sleutel die je op deze pagina maakt, leest alleen: instellingen van de laadpaal wijzigen kan er niet mee.
Je moet eigenaar zijn van een huishouden met minstens één laadpaal om een sleutel te kunnen aanmaken. Leden van een huishouden kunnen dat niet.
Een sleutel aanmaken
- Log in op v2.vetoncontrol.com en open Instellingen, dan "Manage API keys" in de kaart "API keys". Deze pagina is in het Engels.
- Klik op "Create a key" en geef een naam die zegt waar de sleutel gebruikt wordt.
- Kies het bereik: kies een huishouden en vink dan de laadpalen aan die de sleutel mag lezen, of laat ze allemaal uitgevinkt om het hele huishouden te dekken.
- Stel eventueel een vervaldatum in en beperk de sleutel tot de adressen waarvandaan je programma verbinding maakt, onder "Allowed IP addresses".
- Klik op "Create key". Het volledige geheim wordt één keer getoond. Kopieer het naar het programma dat het nodig heeft voordat je de pagina sluit; daarna blijven alleen de eerste tekens zichtbaar.
Behandel het geheim als een wachtwoord. Iedereen die het heeft, kan je laadgeschiedenis lezen. Lekt het uit, trek de sleutel dan in en maak een nieuwe aan.
Houd je sleutels in het oog
Bij elke sleutel zie je wanneer ze aangemaakt is, wanneer ze vervalt als je een datum hebt ingesteld, en wanneer ze het laatst gebruikt is, en vanaf welk adres. Herken je een gebruik niet, trek de sleutel dan in met de knop "Revoke"; ze stopt meteen met werken. Een sleutel stopt ook met werken als je de toegang verliest tot de laadpalen die ze dekt.
Documentatie
De technische referentie is openbaar en staat hieronder gelinkt; ze beschrijft elke aanvraag die een sleutel kan doen. Een snelstart met voorbeeldaanvragen is op aanvraag beschikbaar bij Veton.
Werkt er iets niet?
Vraag het eerst aan je installateur. Je kunt Veton ook bereiken via de contactpagina.
Je API-sleutels beheren Opent op een andere site
Technische referentie voor je integratie Opent op een andere site
Contacteer Veton Opent op een andere site
