Vulpo 1.4Bijgewerkt
Vulpo voor ontwikkelaars
Vulpo is een client voor Home Assistant, geen platform: er is geen openbare HTTP-API, geen webhook-API en geen MCP-server. Hieronder staat alles waarmee een ontwikkelaar of een agent kan integreren, en wat Vulpo van een Home Assistant-server vraagt.
Er is geen openbare API
Vulpo biedt geen HTTP-API, geen OpenAPI-specificatie, geen webhooks, geen SDK en geen MCP-server, en er is geen ontwikkelaarsaccount, API-sleutel of sandbox aan te vragen. Niets in de app is aan te sturen vanaf een server die jij beheert.
Dat is een bewust gevolg van de architectuur: Vulpo heeft geen eigen gegevens. De app leest en schrijft rechtstreeks op je Home Assistant-server en bewaart dashboards in je privé-iCloud-database, dus er is geen backend die een derde partij kan aanroepen. Heb je programmatische toegang tot een huis nodig, gebruik dan de REST- en WebSocket-API’s van Home Assistant op die server.
Machineleesbare endpoints op deze site
Elke pagina van vulpo.app is statische HTML op een eigen URL en is ook beschikbaar als markdown. Zet .md achter een paginapad, of stuur de request-header Accept: text/markdown naar de HTML-URL, dan komt hetzelfde document terug als text/markdown; charset=utf-8.
- https://vulpo.app/llms.txt: index van de site, met een sectie over wanneer je wat gebruikt
- https://vulpo.app/llms-full.txt: de veelgestelde vragen, de vergelijking, de functiepagina’s, de prijzen en de versiegeschiedenis in één document
- https://vulpo.app/sitemap.xml: elke gepubliceerde pagina met een echte lastmod
- https://vulpo.app/robots.txt: crawlbeleid, elke AI-zoekagent en trainingsagent toegestaan
- https://vulpo.app/faq.md en de .md-versie van elke andere pagina
Vulpo automatiseren op het apparaat
De ondersteunde manier om Vulpo vanuit andere software aan te sturen is App Intents. Vulpo levert intents voor Siri, de Opdrachten-app, de actieknop en Spotlight die de status van entiteiten lezen en acties uitvoeren, zodat een opdracht, een automatisering of een verzoek aan Apple Intelligence het huis kan bevragen en bedienen zonder Home Assistant zelf aan te raken.
HomePass exporteert een complete Vulpo-setup (dashboards, kaarten, nieuwe namen, iconen en uiterlijk) als een bestand dat een ander apparaat of een ander persoon kan importeren. Het is de ondersteunde manier om een configuratie te verhuizen of te kopiëren; het formaat is intern en geen openbaar uitwisselingsformaat.
Vereisten voor Home Assistant
Vulpo werkt met elke actuele Home Assistant-release, of die nu draait als Home Assistant OS, Container, Core of Supervised. Op de server is geen aangepaste integratie, add-on of HACS-component nodig.
- WebSocket-API voor de live status, REST- en history-API’s voor grafieken en het logboek
- De integratie mobile_app voor pushmeldingen, apparaatsensoren en locatierapportage
- Een bereikbare URL: een lokaal adres, een extern adres, of allebei met automatisch wisselen
- Functies die afhangen van nieuwere mogelijkheden van Home Assistant, zoals het Energiedashboard of gebieden en verdiepingen, hebben een serverversie nodig die ze biedt
Inlogcontract (IndieAuth)
Vulpo logt in met de standaard IndieAuth-flow van Home Assistant. De client-ID is de site zelf, https://vulpo.app, en de pagina maakt haar redirect-doel bekend met een link rel=redirect_uri-tag die naar vulpo://auth wijst. Home Assistant haalt de site op tijdens het inloggen en leest die tag, dus de pagina is onderdeel van het auth-contract en niet alleen marketing.
Er komen nooit inloggegevens bij Joshua Dessol Design terecht. Het toegangstoken dat Home Assistant uitgeeft, wordt bewaard in de sleutelhanger van het apparaat en wordt nooit naar iCloud gesynchroniseerd of ergens anders heen gestuurd.