Govee (Onafhankelijke uitgever) (preview)
Integreer Govee Smart Light-apparaten in uw toepassingen met de Govee Developer-API. Besturingslichten, wijzig kleuren, pas helderheid aan en stel timers in. Krijg toegang tot de realtime apparaatstatus voor geavanceerde toepassingsontwikkeling.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Richard Wilson |
| URL | https://www.richardawilson.com/ |
| E-mailen | richard.a.wilson@microsoft.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Richard Wilson |
| Webpagina | https://us.govee.com/ |
| Privacybeleid | https://us.govee.com/policies/privacy-policy |
| Categorieën | Internet of Things |
Govee
Biedt naadloze integratie met slimme verlichtingssystemen van Govee , waardoor gebruikers hun apparaten moeiteloos kunnen beheren en beheren. Het biedt een breed scala aan functionaliteiten, waaronder het aanpassen van lichtinstellingen, het wijzigen van kleuren, het wijzigen van helderheid en het openen van de realtime apparaatstatus.
De mogelijkheid om verlichtingsinrichtingen te automatiseren en aan te passen maakt deze connector met name nuttig voor het verbeteren van de sfeer in smart homes, het maken van dynamische belichtingsscènes voor verschillende gelegenheden en het integreren van slimme verlichting in bredere systemen voor huisautomatisering. Het biedt een handige en intuïtieve manier voor gebruikers om hun verlichtingservaring aan te passen en volledig gebruik te maken van de mogelijkheden van de slimme verlichtingstechnologie van Govee.
Uitgever: Richard Wilson
Vereiste voorwaarden
Voordat u de Govee-connector kunt gebruiken, moet u een Govee Developer API-sleutel verkrijgen. Volg deze stappen om de sleutel te verkrijgen:
Een Govee Developer API-sleutel verkrijgen
Download de Govee Home-app:
- Voor iOS: Govee Home in de App Store
- Voor Android: Govee Home op Google Play
Toegang tot uw profiel:
- Open de Govee Home-app en navigeer naar de pagina Mijn profiel door op het profielpictogram (👤) te tikken.
Ga naar Instellingen:
- Klik op het instellingenpictogram (⚙️) in de rechterbovenhoek om het menu Instellingen te openen.
Aanvragen voor API-sleutel:
- Selecteer 'Toepassen op API-sleutel' in het menu Instellingen.
Formulier voor volledige aanvraag:
- Vul de vereiste velden in voor 'Naam' en 'Reden voor toepassing'.
- Voorbeelden van redenen zijn huisautomatisering, integratie van derden of educatieve doeleinden.
- Vul de vereiste velden in voor 'Naam' en 'Reden voor toepassing'.
Ga akkoord met de servicevoorwaarden:
- Lees de Servicevoorwaarden voor govee Developer-API zorgvuldig. Zodra u de voorwaarden hebt begrepen, schakelt u het selectievakje in om uw acceptatie aan te geven.
Toepassing verzenden:
- Klik op Verzenden om uw toepassing voor een API-sleutel te verzenden. Zodra deze is goedgekeurd, ontvangt u uw Govee-API-sleutel, die nodig is om deze connector te gebruiken.
Houd er rekening mee dat het goedkeuringsproces van de API-sleutel enige tijd kan duren en dat goedkeuring naar eigen goeddunken van Govee is. Zorg ervoor dat uw toepassing een geldige en duidelijke reden bevat voor het aanvragen van de API-sleutel om de kans op goedkeuring te vergroten.
Ondersteunde bewerkingen
1. Voer de opdracht uit op het apparaat
Met deze bewerking kunt u verschillende opdrachten verzenden om uw Govee-apparaat te beheren.
-
Invoereigenschappen:
- MAC-adres van apparaat: Het unieke MAC-adres van het Govee-apparaat dat moet worden beheerd.
- Apparaatmodel: Het modelnummer van het Govee-apparaat.
-
Opdrachtdetails: Een object met de opdracht die moet worden uitgevoerd. Dit omvat:
- Naam: De opdrachtnaam (bijvoorbeeld 'turn', 'brightness', 'color', 'colorTem').
- Aanvullende parameters (op basis van de opdracht):
- Schakel het volgende in: (optioneel) 'in' of 'uit': wordt gebruikt wanneer de opdracht 'turn' is.
- Helderheid: (Optioneel) Numerieke waarde (0-100) - wordt gebruikt wanneer de opdracht 'helderheid' is.
- Kleur: (Optioneel) Object met 'r', 'g', 'b'-waarden - gebruikt wanneer de opdracht 'color' is.
- Kleurtemperatuur: (Optioneel) Numerieke waarde voor kleurtemperatuur- wordt gebruikt wanneer de opdracht 'colorTem' is.
2. Apparaatgegevens ophalen
Informatie ophalen over een specifiek Govee-apparaat of alle apparaten die zijn gekoppeld aan uw account.
-
Invoereigenschappen:
- Mac-adres van apparaat: (optioneel) Het MAC-adres van het specifieke Govee-apparaat waarvoor informatie wordt aangevraagd. Als u dit weglaat, wordt informatie voor alle apparaten geretourneerd.
- Apparaatmodel: (optioneel) Het model van het Govee-apparaat. Als deze samen met het MAC-adres is opgegeven, wordt de query verfijnd op dat specifieke apparaat.
API-documentatie
Raadpleeg de officiële Govee-API voor Govee-API voor ontwikkelaars, inclusief de mogelijkheden, eindpunten, parameters en antwoorden. De documentatie bevat uitgebreide richtlijnen en voorbeelden om u te helpen de API effectief te integreren en te gebruiken in uw toepassingen en werkstromen.
Bekende problemen en beperkingen
Er bestaan momenteel geen bekende problemen of beperkingen. Raadpleeg deze sectie altijd voor bijgewerkte informatie.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Govee-API-sleutel | beveiligde string | De Govee-API-sleutel die kan worden aangevraagd in de mobiele Govee-app. | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Apparaatgegevens ophalen |
Krijg gedetailleerde informatie over uw Govee-apparaten. Met dit eindpunt worden gegevens opgehaald voor een specifiek apparaat wanneer het bijbehorende MAC-adres en -model wordt geleverd. Als er geen specifiek apparaat is opgegeven, retourneert het eindpunt informatie voor alle apparaten die zijn gekoppeld aan uw account. Het antwoord bevat apparaatdetails, zoals de apparaatnaam, beheerbaarheid, ophaalbaarheid, ondersteunde opdrachten en aanvullende eigenschappen. Dit is handig om inzicht te krijgen in de mogelijkheden en de huidige configuratie van uw Govee-apparaten. |
| Opdracht uitvoeren op apparaat |
Voer een specifieke opdracht uit op een Govee-apparaat. Met dit eindpunt kunt u verschillende aspecten van het apparaat beheren, zoals energiestatus, helderheid, kleur en kleurtemperatuur. Geef het MAC-adres en model van het apparaat op, samen met de opdrachtdetails. Ondersteunde opdrachten zijn 'draai' voor energiebeheer, 'helderheid' voor het aanpassen van helderheidsniveaus, 'kleur' voor het instellen van RGB-kleurwaarden en 'colorTem' voor het aanpassen van de kleurtemperatuur. |
Apparaatgegevens ophalen
Krijg gedetailleerde informatie over uw Govee-apparaten. Met dit eindpunt worden gegevens opgehaald voor een specifiek apparaat wanneer het bijbehorende MAC-adres en -model wordt geleverd. Als er geen specifiek apparaat is opgegeven, retourneert het eindpunt informatie voor alle apparaten die zijn gekoppeld aan uw account. Het antwoord bevat apparaatdetails, zoals de apparaatnaam, beheerbaarheid, ophaalbaarheid, ondersteunde opdrachten en aanvullende eigenschappen. Dit is handig om inzicht te krijgen in de mogelijkheden en de huidige configuratie van uw Govee-apparaten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
MAC-adres van apparaat
|
device | string |
Een optionele parameter die het MAC-adres van het Govee-apparaat vertegenwoordigt waarvoor informatie wordt aangevraagd. Indien opgegeven, retourneert de API specifiek details voor dit apparaat. Laat deze parameter leeg om informatie op te halen voor alle apparaten die aan het account zijn gekoppeld. |
|
|
Apparaatmodel
|
model | string |
Een optionele parameter die het model van het Govee-apparaat aangeeft. Indien opgegeven, retourneert de API informatie voor apparaten die overeenkomen met dit model. Deze parameter kan worden gebruikt in combinatie met het MAC-adres van het apparaat. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Apparaten
|
data.devices | array of object |
Een lijst met apparaten die zijn gekoppeld aan het account. Als een specifiek apparaat wordt aangevraagd, bevat de lijst slechts één apparaat. |
|
MAC-adres van apparaat
|
data.devices.device | string |
Het unieke MAC-adres van het apparaat |
|
Apparaatmodel
|
data.devices.model | string |
Het modelnummer van het apparaat |
|
Apparaatnaam
|
data.devices.deviceName | string |
De naam van het apparaat |
|
Beheersbaar
|
data.devices.controllable | boolean |
Geeft aan of het apparaat controleerbaar is |
|
Minimaal
|
data.devices.properties.colorTem.range.min | integer |
Minimumwaarde voor kleurtemperatuur |
|
Maximum
|
data.devices.properties.colorTem.range.max | integer |
Maximumwaarde voor kleurtemperatuur |
|
Ophaalbaar
|
data.devices.retrievable | boolean |
Geeft aan of het apparaat kan worden opgehaald |
|
Ondersteunde opdrachten
|
data.devices.supportCmds | array of string |
Ondersteunde opdrachten voor het apparaat |
|
Message
|
message | string |
Een bericht met een beschrijving van het resultaat van de bewerking |
|
Statuscode
|
code | integer |
De HTTP-statuscode van het antwoord |
Opdracht uitvoeren op apparaat
Voer een specifieke opdracht uit op een Govee-apparaat. Met dit eindpunt kunt u verschillende aspecten van het apparaat beheren, zoals energiestatus, helderheid, kleur en kleurtemperatuur. Geef het MAC-adres en model van het apparaat op, samen met de opdrachtdetails. Ondersteunde opdrachten zijn 'draai' voor energiebeheer, 'helderheid' voor het aanpassen van helderheidsniveaus, 'kleur' voor het instellen van RGB-kleurwaarden en 'colorTem' voor het aanpassen van de kleurtemperatuur.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
MAC-adres van apparaat
|
device | True | string |
Het unieke MAC-adres van het Govee-apparaat. Deze id wordt gebruikt om op te geven welk apparaat u wilt beheren. |
|
Apparaatmodel
|
model | True | string |
Het modelnummer van uw Govee-apparaat. Deze informatie helpt bij het identificeren van de specifieke functies en mogelijkheden die beschikbaar zijn voor het apparaat. |
|
Opdrachtnaam
|
name | True | string |
De opdracht die moet worden uitgevoerd op het apparaat. Dit object bevat de opdrachtnaam (bijvoorbeeld 'turn', 'brightness', 'color', 'colorTem') en de bijbehorende waarde. De opdrachtnaam bepaalt het type actie dat moet worden uitgevoerd op het apparaat. |
|
Draaien
|
turn | string |
Deze parameter wordt gebruikt om het apparaat in of uit te schakelen. Gebruik deze optie alleen wanneer de opdracht Turn is geselecteerd. Geldige waarden zijn 'aan' of 'uit'. |
|
|
Helderheid
|
brightness | integer |
Het helderheidsniveau dat moet worden ingesteld voor het apparaat. Gebruik deze parameter alleen wanneer de opdracht Helderheid is geselecteerd. Voer een waarde in tussen 0 (minimale helderheid) en 100 (maximale helderheid). |
|
|
Kleur - rood
|
r | integer |
Deze parameter vertegenwoordigt het rode onderdeel van de RGB-kleurwaarde voor het apparaat. Het maakt deel uit van de opdracht 'color'. Geef een geheel getal op tussen 0 en 255, waarbij 0 betekent dat er geen rood en 255 de maximale intensiteit van rood aangeeft. |
|
|
Kleur - groen
|
g | integer |
Deze parameter definieert het groene onderdeel van de RGB-kleurwaarde voor het apparaat. Deze wordt gebruikt in combinatie met de opdracht 'color'. Geef een geheel getal op tussen 0 en 255, waarbij 0 aangeeft dat er geen groen en 255 zijn die de hoogste intensiteit van groen aangeven. |
|
|
Kleur - blauw
|
b | integer |
Het blauwe onderdeel van de RGB-kleurwaarde die moet worden ingesteld op het apparaat. Deze parameter maakt deel uit van de opdracht 'color'. De waarde moet een geheel getal zijn van 0 tot 255, waarbij 0 het ontbreken van blauw is en 255 het helderste blauw aangeeft. |
|
|
Kleurtemperatuur
|
colorTem | integer |
De kleurtemperatuurwaarde die moet worden ingesteld voor het apparaat. Gebruik deze parameter alleen wanneer de opdracht colorTem is geselecteerd. Voer de kleurtemperatuurwaarde in zoals vereist door uw apparaat. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Statuscode
|
code | integer |
De HTTP-statuscode van het antwoord |
|
Message
|
message | string |
Een bericht met een beschrijving van het resultaat van de bewerking |
|
gegevens
|
data | object |
De gegevens die worden geretourneerd met het antwoord. |