API externe

Référence de l’API

Lecture seule, pour la domotique, les scripts et les tableaux de bord. Une clé d’API désigne un foyer et les modules qu’elle peut lire : Bernard, Lulu, Léon, Annie.

• Créer une clé : dans l’application, Paramètres du foyer → Clés d’API (propriétaire ou administrateur). La clé n’est affichée qu’une fois.
• S’authentifier : Authorization: Bearer bcl_… ou X-API-Key: bcl_…, jamais dans l’URL.
• Découvrir : guide de l’API (clés, exemples curl, erreurs) et openapi.yaml, le contrat source de cette page.

« Essayer » depuis cette page appelle l’API directement depuis votre navigateur : le navigateur exige alors l’autorisation CORS du serveur, qui n’est pas encore ouverte. Utilisez curl en attendant, ou la même origine que l’application.