tuya Referenca API-ja za upravljanje uređajima u oblaku
Informacije o proizvodu
Proizvod za kontrolu uređaja pruža skup API-ja i instrukcija za daljinsko upravljanje uređajima. Korisnici mogu slati instrukcije uređaju koristeći priložene API krajnje tačke.
specifikacije:
- Kontrola uređaja
- verzija: 20240124
- Online verzija
Upute za upotrebu proizvoda
- Nabavite set instrukcija po kategoriji:
Korisnici mogu dohvatiti skup instrukcija po kategorijama koristeći sljedeće API krajnje točke:- API opis
- API adresa
- Parametar zahtjeva
- Povratni parametar
- Zahtjev Example
- SDK Example
- Odgovor Example
- Kod greške
- Nabavite set instrukcija po uređaju:
Da bi dobili instrukcije koje je postavio uređaj, korisnici mogu koristiti dostavljene API krajnje točke za određene uređaje. Ovo uključuje detalje kao što su API adresa, parametri zahtjeva, parametri povrata i npramples. - Nabavite set instrukcija po uređajima:
Ova funkcija omogućava korisnicima pristup skupu instrukcija za više uređaja. Korisnici mogu postavljati zahtjeve koristeći API adresu i navedene parametre. - Dobijte specifikacije i svojstva uređaja:
Ova krajnja tačka API-ja pruža detaljne specifikacije i svojstva uređaja, uključujući skup instrukcija i skup statusa. Korisnici mogu zatražiti ove informacije zajedno sa nprampinformacije o tome kako koristiti SDK. - Pošaljite instrukcije na uređaj:
Korisnici mogu slati određena uputstva uređaju koristeći priloženi API. Ovo uključuje detalje kao što su parametri zahtjeva, povratni parametri i nprampinformacije o tome kako efikasno poslati uputstva.
FAQ:
- P: Kako mogu riješiti problem ako naiđem na greške prilikom slanja instrukcija?
O: Ako naiđete na greške prilikom slanja instrukcija, pogledajte odjeljak koda greške u API dokumentaciji da biste identificirali i riješili problem. - P: Mogu li kontrolisati više uređaja istovremeno?
O: Da, možete istovremeno kontrolisati više uređaja koristeći uputstva postavljena od strane funkcije uređaja i postavljajući zahteve za svaki uređaj u skladu s tim.
Ova tema opisuje API-je povezane s kontrolom uređaja, uključujući dobivanje skupova instrukcija, specifikacija, svojstava, najnovijih statusa i slanje instrukcija.
Preuzmite instrukcije po kategorijama
API opis
Upitajte skup instrukcija po kategoriji. Ovaj skup instrukcija ima najveću količinu instrukcija u kategoriji sve-u-jednom aplikacija, koje programeri mogu koristiti i na koje se pozivaju. Ako ste programer platforme, možete razvijati aplikacije prema ovom skupu uputa.
API adresa
- GET /v1.0/ funkcije /{ kategorija}
Parametar zahtjeva
Povratni parametar
- Opis rezultata
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kategorija| String | Kategorija proizvoda |
- | funkcije| Lista | Set instrukcija |
- Opis funkcija
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kod | String | Uputstvo | | tip | String | Vrsta instrukcije |
- | vrijednosti | String | Raspon vrijednosti ulaznih parametara |
- | ime | String | Naziv instrukcije |
- | desc | String | Opis |
Zahtjev example
- GET /v1.0/ funkcije/kg
SDK example
Odgovor prample
Kôd greške
Sljedeće su uobičajeni servisni izuzeci za ovo sučelje. Za više grešaka izuzetaka, pogledajte Kod greške.
Preuzmite instrukcije po uređaju
API opis
Upitajte funkcije koje uređaj podržava. Kontrolu možete poslati po dobijenim uputama.
API adresa
- GET /v1.0/ devices /{ device_id }/ funkcije
Parametar zahtjeva
Povratni parametar
- Opis rezultata
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kategorija| String | Kategorija proizvoda |
- | funkcije| Lista | Set instrukcija |
- Opis funkcija
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kod | String | Uputstvo |
- | tip | String | Vrsta instrukcije |
- | vrijednosti | String | Raspon vrijednosti ulaznih parametara |
- | ime | String | Naziv instrukcije |
- | desc | String | Opis |
Zahtjev example
- GET /v1.0/ devices/vdevo155XXXX83954683/functions
SDK example
- TuyaClient klijent = novi TuyaClient(clientId, secret, RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevId(DEV_ID);
- System.out.println(“Nabavite listu funkcija prema ID-u uređaja: “);
- System.out.println(JSONObject.toJSONString(funkcije kategorije));
Odgovor prample
Kôd greške
Sljedeće su uobičajeni servisni izuzeci za ovo sučelje. Za više grešaka izuzetaka, pogledajte Kod greške.
Preuzmite instrukcije po uređajima
API opis
Potražite funkcije koje podržava lista uređaja. Kontrolu možete poslati po dobijenim uputama. podržava do 20 uređaja
API adresa
- GET /v1.0/ uređaji/funkcije
Parametar zahtjeva
Povratni parametar
- Opis rezultata
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kategorija| String | Kategorija proizvoda |
- | funkcije| Lista | Set instrukcija |
- | uređaji | Lista | Lista ID-ova uređaja |
- Opis funkcija
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kod | String | Uputstvo |
- | tip | String | Vrsta instrukcije |
- | vrijednosti | String | Raspon vrijednosti ulaznih parametara |
- | ime | String | Naziv instrukcije |
- | desc | String | Opis |
Zahtjev example
- GET /v1.0/ devices/functions?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
- a517fbc901dtln
SDK example
- TuyaClient klijent = novi TuyaClient(clientId, secret, RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
- System.out.println(“Nabavite listu funkcija po listi uređaja: “);
- System.out.println(JSONObject.toJSONString(funkcije kategorije));
Odgovor prample
Kôd greške
Sljedeće su uobičajeni servisni izuzeci za ovo sučelje. Za više grešaka izuzetaka, pogledajte Kod greške.
Specifikacije i svojstva uređaja
Dobijte specifikacije i svojstva uređaja, uključujući skup instrukcija i set statusa
API opis
Ovo sučelje se koristi za dobivanje skupa instrukcija i skupa statusa koje podržava uređaj prema ID-u uređaja.
API adresa
- GET /v1.0/ uređaji /{ device_id }/ specifikacije
Parametar zahtjeva
Povratni parametar
- Opis rezultata
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kategorija | String | Kategorija proizvoda |
- | funkcije | Lista | Set instrukcija |
- | status | Lista | Status postavljen |
- Opis funkcija
- | Naziv parametra | Kategorija | Opis |
- | :—- | :—- | :—|
- | kod | String | komanda |
- | tip | String | Vrsta |
- | vrijednosti | String | Raspon vrijednosti parametara |
- Opis statusa
- | Naziv parametra | Kategorija | Opis |
- | :—| :—| :—|
- | kod | String | statusni kod |
- | tip | String | Vrsta |
- | vrijednosti | String | Raspon vrijednosti parametara |
Zahtjev example
- GET /v1.0/ devices/vdevoXXXXXXXXXXXXXXX/specifikacije
SDK example
N/A
Povratni parametar
Pošaljite upute na uređaj
API opis
Ovaj interfejs se koristi za slanje jednog ili više dobijenih skupova instrukcija. Da li se skupovi instrukcija mogu slati istovremeno zavisi od proizvoda.
API adresa
- POST /v1.0/ devices /{ device_id }/ komande
Parametar zahtjeva
Povratni parametar
Zahtjev example
- POST /v1.0/ devices/vdevo1552XXXX3954683/commands
SDK example
Odgovor prample
Kôd greške
Sljedeće su uobičajeni servisni izuzeci za ovo sučelje. Za više grešaka izuzetaka, pogledajte Kod greške.
Dobijte najnoviji status uređaja
API opis
Dobijte najnoviji status uređaja prema ID-u uređaja
API adresa
- GET /v1.0/ uređaji /{ device_id }/ status
Parametar zahtjeva
Povratni parametar
Zahtjev example
- GET /v1.0/ uređaji /{ device_id }/ status
SDK example
Odgovor prample
Kôd greške
Sljedeće su uobičajeni servisni izuzeci za ovo sučelje. Za više grešaka izuzetaka, pogledajte Kod greške.
Dokumenti / Resursi
 |
tuya Referenca API-ja za upravljanje uređajima u oblaku [pdf] Korisnički priručnik Kontrola uređaja Cloud Services API Reference, Cloud Services API Reference, API Reference |
