Govee (Éditeur indépendant) (préversion)
Intégrez des appareils de lumière intelligente Govee dans vos applications à l’API Développeur Govee. Contrôler les lumières, modifier les couleurs, ajuster la luminosité et définir des minuteurs. Accédez à l’état de l’appareil en temps réel pour le développement d’applications avancé.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Richard Wilson |
| URL | https://www.richardawilson.com/ |
| Messagerie électronique | richard.a.wilson@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Richard Wilson |
| Site internet | https://us.govee.com/ |
| Politique de confidentialité | https://us.govee.com/policies/privacy-policy |
| Catégories | Internet des objets |
Govee
Offre une intégration transparente avec les systèmes d’éclairage intelligent de Govee , ce qui permet aux utilisateurs de contrôler et de gérer facilement leurs appareils. Il permet un large éventail de fonctionnalités, notamment l’ajustement des paramètres de lumière, la modification des couleurs, la modification de la luminosité et l’accès à l’état de l’appareil en temps réel.
La possibilité d’automatiser et de personnaliser les configurations d’éclairage rend ce connecteur particulièrement utile pour améliorer l’ambiance dans les maisons intelligentes, créer des scènes d’éclairage dynamique à diverses occasions et intégrer l’éclairage intelligent dans des systèmes d’automatisation domestique plus larges. Il offre un moyen pratique et intuitif pour les utilisateurs de personnaliser leur expérience d’éclairage et tirer pleinement parti des fonctionnalités de la technologie d’éclairage intelligent de Govee.
Éditeur : Richard Wilson
Prerequisites
Avant de pouvoir utiliser le connecteur Govee, vous devez obtenir une clé API développeur Govee. Procédez comme suit pour acquérir la clé :
Obtention d’une clé API développeur Govee
Téléchargez l’application d’accueil Govee :
- Pour iOS : Govee Home sur l’App Store
- Pour Android : Govee Home sur Google Play
Accédez à votre profil :
- Ouvrez l’application d’accueil Govee et accédez à la page « Mon profil » en appuyant sur l’icône de profil (👤).
Accédez aux paramètres :
- Cliquez sur l’icône paramètres (⚙️) située en haut à droite pour accéder au menu Paramètres.
Appliquez la clé API :
- Sélectionnez « Appliquer pour la clé API » dans le menu Paramètres.
Formulaire d’application complet :
- Renseignez les champs obligatoires pour « Nom » et « Raison de l’application ».
- Les exemples de raisons incluent l’automatisation à domicile, l’intégration tierce ou les objectifs éducatifs.
- Renseignez les champs obligatoires pour « Nom » et « Raison de l’application ».
Acceptez les conditions d’utilisation :
- Lisez attentivement les conditions d’utilisation de l’API Développeur Govee. Une fois que vous avez compris les termes, cochez la case pour indiquer votre acceptation.
Soumettre une application :
- Cliquez sur « Envoyer » pour envoyer votre application pour une clé API. Une fois approuvée, vous recevrez votre clé API Govee, ce qui est nécessaire pour utiliser ce connecteur.
Sachez que le processus d’approbation de la clé API peut prendre un certain temps et que l’approbation est à la discrétion de Govee. Assurez-vous que votre application inclut une raison valide et claire de demander la clé API pour augmenter la probabilité d’approbation.
Opérations prises en charge
1. Exécuter la commande sur l’appareil
Cette opération vous permet d’envoyer différentes commandes pour contrôler votre appareil Govee.
-
Propriétés d’entrée :
- Adresse MAC de l’appareil : Adresse MAC unique de l’appareil Govee à contrôler.
- Modèle d’appareil : Numéro de modèle de l’appareil Govee.
-
Détails de la commande : Objet contenant la commande à exécuter. Il inclut les éléments suivants :
- Nom: Nom de la commande (par exemple, « turn », « brightness », « color », « colorTem »).
- Paramètres supplémentaires (basés sur la commande) :
- Activer : (facultatif) 'on' ou 'off' - utilisé lorsque la commande est 'turn'.
- Luminosité : (Facultatif) Valeur numérique (0-100) - utilisée lorsque la commande est « luminosité ».
- Couleur : (Facultatif) Objet avec « r », « g », « b », valeurs utilisées lorsque la commande est « color ».
- Température de couleur : (facultatif) Valeur numérique pour la température de couleur utilisée lorsque la commande est « colorTem ».
2. Obtenir des informations sur l’appareil
Récupérez des informations sur un appareil Govee spécifique ou tous les appareils associés à votre compte.
-
Propriétés d’entrée :
- Adresse MAC de l’appareil : (facultatif) Adresse MAC de l’appareil Govee spécifique pour lequel les informations sont demandées. En cas d’omission, les informations de tous les appareils sont retournées.
- Modèle d’appareil : (facultatif) Modèle de l’appareil Govee. Si elle est spécifiée avec l’adresse MAC, elle affine la requête à cet appareil spécifique.
Documentation sur l’API
Pour plus d’informations sur l’API Govee Lights Developer, notamment ses fonctionnalités, points de terminaison, paramètres et réponses, reportez-vous à la documentation officielle de l’API Govee. La documentation fournit des conseils et des exemples complets pour vous aider à intégrer et utiliser efficacement l’API au sein de vos applications et flux de travail.
Problèmes connus et limitations
Actuellement, aucun problème ou limitations connus n’existe. Reportez-vous toujours à cette section pour obtenir des informations mises à jour.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé API Govee | securestring | Clé API Govee qui peut être demandée dans l’application mobile Govee. | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Exécuter la commande sur l’appareil |
Exécutez une commande spécifique sur un appareil Govee. Ce point de terminaison vous permet de contrôler différents aspects de l’appareil, tels que l’état de l’alimentation, la luminosité, la couleur et la température des couleurs. Fournissez l’adresse MAC et le modèle de l’appareil, ainsi que les détails de la commande. Les commandes prises en charge incluent « turn » pour le contrôle d’alimentation, « luminosité » pour ajuster les niveaux de luminosité, « color » pour définir des valeurs de couleur RVB et « colorTem » pour ajuster la température de couleur. |
| Obtenir des informations sur l’appareil |
Accédez à des informations détaillées sur vos appareils Govee. Ce point de terminaison récupère les données d’un appareil spécifique lorsqu’il est fourni avec son adresse MAC et son modèle. Si aucun appareil spécifique n’est spécifié, le point de terminaison retourne des informations pour tous les appareils associés à votre compte. La réponse inclut les détails de l’appareil, tels que le nom de l’appareil, la contrôle, la récupération, les commandes prises en charge et des propriétés supplémentaires. Cela est utile pour comprendre les fonctionnalités et la configuration actuelle de vos appareils Govee. |
Exécuter la commande sur l’appareil
Exécutez une commande spécifique sur un appareil Govee. Ce point de terminaison vous permet de contrôler différents aspects de l’appareil, tels que l’état de l’alimentation, la luminosité, la couleur et la température des couleurs. Fournissez l’adresse MAC et le modèle de l’appareil, ainsi que les détails de la commande. Les commandes prises en charge incluent « turn » pour le contrôle d’alimentation, « luminosité » pour ajuster les niveaux de luminosité, « color » pour définir des valeurs de couleur RVB et « colorTem » pour ajuster la température de couleur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Adresse MAC de l’appareil
|
device | True | string |
Adresse MAC unique de l’appareil Govee. Cet identificateur est utilisé pour spécifier l’appareil que vous souhaitez contrôler. |
|
Modèle de l’appareil
|
model | True | string |
Numéro de modèle de votre appareil Govee. Ces informations permettent d’identifier les fonctionnalités et fonctionnalités spécifiques disponibles pour l’appareil. |
|
Nom de la commande
|
name | True | string |
Commande à exécuter sur l’appareil. Cet objet inclut le nom de la commande (par exemple, « turn », « brightness », « color », « colorTem ») et sa valeur associée. Le nom de la commande détermine le type d’action à effectuer sur l’appareil. |
|
Tour
|
turn | string |
Ce paramètre est utilisé pour activer ou désactiver l’appareil. Utilisez cette option uniquement lorsque la commande « turn » est sélectionnée. Les valeurs valides sont « on » ou « off ». |
|
|
Luminosité
|
brightness | integer |
Niveau de luminosité à définir pour l’appareil. Utilisez ce paramètre uniquement lorsque la commande « brightness » est sélectionnée. Entrez une valeur comprise entre 0 (luminosité minimale) et 100 (luminosité maximale). |
|
|
Couleur - Rouge
|
r | integer |
Ce paramètre représente le composant rouge de la valeur de couleur RVB pour l’appareil. Il fait partie de la commande « color ». Spécifiez une valeur entière comprise entre 0 et 255, où 0 signifie qu’aucun rouge et 255 représente l’intensité maximale de rouge. |
|
|
Couleur - Vert
|
g | integer |
Ce paramètre définit le composant vert de la valeur de couleur RVB pour l’appareil. Il est utilisé conjointement avec la commande « color ». Fournissez une valeur entière comprise entre 0 et 255, avec 0 indiquant aucun vert et 255 indiquant l’intensité la plus élevée de vert. |
|
|
Couleur - Bleu
|
b | integer |
Composant bleu de la valeur de couleur RVB à définir sur l’appareil. Ce paramètre fait partie de la commande « color ». La valeur doit être un entier compris entre 0 et 255, où 0 est l’absence de bleu et 255 indique le bleu le plus lumineux. |
|
|
Température des couleurs
|
colorTem | integer |
Valeur de température de couleur à définir pour l’appareil. Utilisez ce paramètre uniquement lorsque la commande « colorTem » est sélectionnée. Entrez la valeur de température de couleur requise par votre appareil. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Code de statut
|
code | integer |
Code d’état HTTP de la réponse |
|
Message
|
message | string |
Message décrivant le résultat de l’opération |
|
données
|
data | object |
Données retournées avec la réponse. |
Obtenir des informations sur l’appareil
Accédez à des informations détaillées sur vos appareils Govee. Ce point de terminaison récupère les données d’un appareil spécifique lorsqu’il est fourni avec son adresse MAC et son modèle. Si aucun appareil spécifique n’est spécifié, le point de terminaison retourne des informations pour tous les appareils associés à votre compte. La réponse inclut les détails de l’appareil, tels que le nom de l’appareil, la contrôle, la récupération, les commandes prises en charge et des propriétés supplémentaires. Cela est utile pour comprendre les fonctionnalités et la configuration actuelle de vos appareils Govee.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Adresse MAC de l’appareil
|
device | string |
Paramètre facultatif représentant l’adresse MAC de l’appareil Govee pour lequel les informations sont demandées. Si elle est fournie, l’API retourne des détails spécifiquement pour cet appareil. Laissez ce paramètre vide pour récupérer des informations pour tous les appareils associés au compte. |
|
|
Modèle de l’appareil
|
model | string |
Paramètre facultatif indiquant le modèle de l’appareil Govee. Si elle est spécifiée, l’API retourne des informations pour les appareils correspondant à ce modèle. Ce paramètre peut être utilisé conjointement avec l’adresse MAC de l’appareil. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Appareils
|
data.devices | array of object |
Liste des appareils associés au compte. Si un appareil spécifique est demandé, la liste ne contient qu’un seul appareil. |
|
Adresse MAC de l’appareil
|
data.devices.device | string |
Adresse MAC unique de l’appareil |
|
Modèle de l’appareil
|
data.devices.model | string |
Numéro de modèle de l’appareil |
|
Nom de l’appareil
|
data.devices.deviceName | string |
Nom de l’appareil |
|
Contrôlable
|
data.devices.controllable | boolean |
Indique si l’appareil est contrôlable |
|
Minimum
|
data.devices.properties.colorTem.range.min | integer |
Valeur minimale de température de couleur |
|
Maximale
|
data.devices.properties.colorTem.range.max | integer |
Valeur de température de couleur maximale |
|
Affichable dans les résultats d’une recherche
|
data.devices.retrievable | boolean |
Indique si l’appareil est récupérable |
|
Commandes prises en charge
|
data.devices.supportCmds | array of string |
Commandes prises en charge pour l’appareil |
|
Message
|
message | string |
Message décrivant le résultat de l’opération |
|
Code de statut
|
code | integer |
Code d’état HTTP de la réponse |