tuya Device Control Cloud Services API Reference User Guide

tuya Toestelbeheer Wolkdienste API-verwysing

Produk inligting

Die Device Control-produk verskaf 'n stel API's en instruksies om toestelle op afstand te beheer. Gebruikers kan instruksies na die toestel stuur deur die verskafde API-eindpunte te gebruik.

Spesifikasies:

Toestelbeheer
Weergawe: 20240124
Aanlyn weergawe

Produkgebruiksinstruksies

Kry die instruksiesstel volgens kategorie:
Gebruikers kan die instruksies per kategorie ophaal deur die volgende API-eindpunte te gebruik:
- API beskrywing
- API-adres
- Versoek parameter
- Return parameter
- Versoek Bvample
- SDK Bvample
- Reaksie Bvample
- Foutkode
Kry die instruksiesstel per toestel:
Om die instruksies wat deur die toestel gestel is, te verkry, kan gebruikers die verskafde API-eindpunte vir spesifieke toestelle gebruik. Dit sluit besonderhede in soos API-adres, versoekparameters, terugkeerparameters en bvamples.
Kry die instruksiesstel deur toestelle:
Hierdie kenmerk laat gebruikers toe om toegang tot die instruksiesstel vir verskeie toestelle te kry. Gebruikers kan versoeke maak met behulp van die API-adres en parameters wat verskaf word.
Kry die spesifikasies en eienskappe van die toestel:
Hierdie API-eindpunt verskaf gedetailleerde spesifikasies en eienskappe van die toestel, insluitend die instruksiestel en statusstel. Gebruikers kan hierdie inligting aanvra saam met bvamplees van hoe om die SDK te gebruik.
Stuur instruksies na die toestel:
Gebruikers kan spesifieke instruksies na die toestel stuur deur die verskafde API te gebruik. Dit sluit besonderhede in soos versoekparameters, terugkeerparameters en bvamples van hoe om instruksies effektief te stuur.

Gereelde vrae:

V: Hoe kan ek foutspoor as ek foute ondervind wanneer instruksies gestuur word?
A: As jy foute teëkom wanneer instruksies gestuur word, verwys na die foutkode-afdeling in die API-dokumentasie om die probleem te identifiseer en op te los.
V: Kan ek verskeie toestelle gelyktydig beheer?
A: Ja, jy kan veelvuldige toestelle gelyktydig beheer deur die instruksies te gebruik wat deur die toestelkenmerk gestel word en dienooreenkomstig versoeke vir elke toestel te rig.

Hierdie onderwerp beskryf die API's wat met toestelbeheer verband hou, insluitend die kry van instruksiestelle, spesifikasies, eienskappe, die nuutste statusse en stuur van instruksies.

Kry die instruksies volgens kategorie

API beskrywing
Besoek die instruksie wat volgens kategorie gestel is. Hierdie instruksiestel het die grootste hoeveelheid instruksies in die kategorie van alles-in-een-toepassings, wat deur ontwikkelaars gebruik en na verwys kan word. As jy 'n platformontwikkelaar is, kan jy toepassings volgens hierdie instruksiestel ontwikkel.

API-adres

KRY /v1.0/ funksies /{ kategorie}

Versoek parameter

Terugkeer parameter

Beskrywing van resultaat
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kategorie| Snaar | Produkkategorie |
- | funksies| Lys | Instruksiestel |
Beskrywing van funksies
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kode | Snaar | Instruksie | | tik | Snaar | Instruksie tipe |
- | waardes | Snaar | Die reeks invoerparameterwaardes |
- | naam | Snaar | Instruksienaam |
- | beskryf | Snaar | Beskrywing |

Versoek bvample

KRY /v1.0/ funksies/kg

SDK bvample

Reaksie bvample

Foutkode
Die volgende is algemene diensuitsonderings vir hierdie koppelvlak. Vir meer uitsonderingsfoute, sien Foutkode.

Kry die instruksie wat per toestel gestel is

API beskrywing
Doen navraag oor die funksies wat deur die toestel ondersteun word. U kan beheer stuur deur die verkrygde instruksies.

API-adres

KRY /v1.0/ toestelle /{ device_id }/ funksies

Versoek parameter

Terugkeer parameter

Beskrywing van resultaat
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kategorie| Snaar | Produkkategorie |
- | funksies| Lys | Instruksiestel |
Beskrywing van funksies
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kode | Snaar | Instruksie |
- | tik | Snaar | Instruksie tipe |
- | waardes | Snaar | Die reeks invoerparameterwaardes |
- | naam | Snaar | Instruksienaam |
- | beskryf | Snaar | Beskrywing |

Versoek bvample

KRY /v1.0/ toestelle/vdevo155XXXX83954683/funksies

SDK bvample

TuyaClient-kliënt = nuwe TuyaClient(clientId , secret , RegionEnum.CN);
categoryFunctions = client.getFunctionsByDevId(DEV_ID);
System.out.println(“Kry die funksielys volgens toestel-ID: “);
System.out.println(JSONObject.toJSONString(kategorie Funksies));

Reaksie bvample

Foutkode
Die volgende is algemene diensuitsonderings vir hierdie koppelvlak. Vir meer uitsonderingsfoute, sien Foutkode.

Kry die instruksies wat deur toestelle gestel word

API beskrywing
Besoek die funksies wat deur die toestellelys ondersteun word. U kan beheer stuur deur die verkrygde instruksies. ondersteun tot 20 toestelle

API-adres

KRY /v1.0/ toestelle/funksies

Versoek parameter

Terugkeer parameter

Beskrywing van resultaat
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kategorie| Snaar | Produkkategorie |
- | funksies| Lys | Instruksiestel |
- | toestelle | Lys | toestel-ID lys |
Beskrywing van funksies
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kode | Snaar | Instruksie |
- | tik | Snaar | Instruksie tipe |
- | waardes | Snaar | Die reeks invoerparameterwaardes |
- | naam | Snaar | Instruksienaam |
- | beskryf | Snaar | Beskrywing |

Versoek bvample

KRY /v1.0/ toestelle/funksies?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
a517fbc901dtln

SDK bvample

TuyaClient-kliënt = nuwe TuyaClient(clientId , secret , RegionEnum.CN);
categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
System.out.println(“Kry die funksielys volgens toestelle Lys: “);
System.out.println(JSONObject.toJSONString(kategorie Funksies));

Reaksie bvample

Foutkode
Die volgende is algemene diensuitsonderings vir hierdie koppelvlak. Vir meer uitsonderingsfoute, sien Foutkode.

Spesifikasies en eienskappe van die toestel

Kry die spesifikasies en eienskappe van die toestel, insluitend die instruksiestel en statusstel

API beskrywing
Hierdie koppelvlak word gebruik om die instruksiestel en statusstel volgens die toestel-ID deur die toestel ondersteun te kry.

API-adres

KRY /v1.0/ toestelle /{ device_id }/ spesifikasies

Versoek parameter

Terugkeer parameter

Beskrywing van resultaat
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kategorie | Snaar | Produkkategorie |
- | funksies | Lys | Instruksiestel |
- | status | Lys | Status gestel |
Beskrywing van funksies
- | Parameter naam | Kategorie | Beskrywing |
- | :—- | :—- | :—|
- | kode | Snaar | bevel |
- | tik | Snaar | Tik |
- | waardes | Snaar | Die reeks parameterwaardes |
Beskrywing van status
- | Parameter naam | Kategorie | Beskrywing |
- | :—| :—| :—|
- | kode | Snaar | status kode |
- | tik | Snaar | Tik |
- | waardes | Snaar | Die reeks parameterwaardes |

Versoek bvample

KRY /v1.0/ toestelle/vdevoXXXXXXXXXXXXXXX/spesifikasies

SDK bvample
NVT

Terugkeer parameter

Stuur instruksies na die toestel

API beskrywing
Hierdie koppelvlak word gebruik om een of meer verkrygde instruksiestelle te stuur. Of instruksiestelle gelyktydig gestuur kan word, hang af van die produk.

API-adres