Vulpo 1.4Mis à jour le
Ressources pour développeurs de Vulpo
Vulpo est un client Home Assistant, pas une plateforme : il n’y a ni API HTTP publique, ni API de webhooks, ni serveur MCP. Voici tout ce qu’un développeur, une développeuse ou un agent peut utiliser pour s’intégrer à Vulpo, et ce que Vulpo attend d’un serveur Home Assistant.
Il n’y a pas d’API publique
Vulpo n’expose ni API HTTP, ni spécification OpenAPI, ni webhooks, ni SDK, ni serveur MCP, et il n’existe aucun compte développeur, aucune clé d’API et aucun bac à sable à demander. Rien dans l’app ne peut être piloté depuis un serveur que tu contrôles.
C’est une conséquence voulue de l’architecture : Vulpo ne détient aucune donnée qui lui soit propre. Il lit et écrit directement sur ton serveur Home Assistant et stocke les tableaux de bord dans ta base de données iCloud privée ; il n’y a donc aucun backend qu’un tiers pourrait appeler. Pour accéder à une maison par programmation, utilise les API REST et WebSocket de Home Assistant sur ce serveur.
Points d’accès lisibles par les machines sur ce site
Chaque page de vulpo.app est du HTML statique à sa propre URL, et chaque page en anglais existe aussi en markdown. Ajoute .md au chemin de la page, ou envoie l’en-tête de requête Accept: text/markdown à l’URL HTML, et le même document revient en text/markdown; charset=utf-8.
- https://vulpo.app/llms.txt : index du site, avec une section qui indique quand l’utiliser
- https://vulpo.app/llms-full.txt : la FAQ, la comparaison, les pages de fonctionnalités, les tarifs et les notes de version en un seul document
- https://vulpo.app/sitemap.xml : toutes les pages publiées, avec un vrai lastmod
- https://vulpo.app/robots.txt : règles d’exploration, tous les agents de recherche et d’entraînement d’IA autorisés
- https://vulpo.app/faq.md et le jumeau .md de n’importe quelle autre page en anglais
Automatiser Vulpo sur l’appareil
Pour piloter Vulpo depuis un autre logiciel, la voie prévue passe par les App Intents. Vulpo fournit des intents pour Siri, l’app Raccourcis, le bouton Action et Spotlight, qui lisent l’état des entités et lancent des actions : un raccourci, une automatisation ou une requête Apple Intelligence peut ainsi interroger la maison et la contrôler sans passer directement par Home Assistant.
HomePass exporte une configuration Vulpo complète (tableaux de bord, cartes, renommages, icônes et apparence) dans un fichier qu’un autre appareil ou une autre personne peut importer. C’est la façon prévue de déplacer ou de dupliquer une configuration ; le format est interne et n’est pas un format d’échange public.
Ce qu’il faut côté Home Assistant
Vulpo fonctionne avec toute version actuelle de Home Assistant, qu’elle tourne en Home Assistant OS, Container, Core ou Supervised. Il ne demande aucune intégration personnalisée, aucune application Home Assistant (add-on) et aucun composant HACS sur le serveur.
- L’API WebSocket pour l’état en direct, les API REST et d’historique pour les graphiques et le journal
- L’intégration mobile_app pour les notifications push, les capteurs de l’appareil et la remontée de position
- Une URL joignable : une adresse locale, une adresse externe, ou les deux avec bascule automatique
- Les fonctionnalités qui dépendent de capacités récentes de Home Assistant, comme le tableau de bord Énergie ou les zones et étages, demandent une version du serveur qui les propose
Contrat de connexion (IndieAuth)
Vulpo se connecte avec le flux IndieAuth standard de Home Assistant. L’identifiant du client est le site lui-même, https://vulpo.app, et la page annonce sa cible de redirection avec une balise link rel=redirect_uri qui pointe vers vulpo://auth. Home Assistant récupère le site pendant la connexion et lit cette balise : la page fait donc partie du contrat d’authentification, et pas seulement du marketing.
Aucun identifiant n’arrive jamais chez Joshua Dessol Design. Le jeton d’accès délivré par Home Assistant est stocké dans le trousseau de l’appareil, et n’est jamais synchronisé avec iCloud ni envoyé ailleurs.