tuya Device Control Cloud Services API Reference User Guide

tuya Device Control Cloud Services API-viite

Tuotetiedot

Device Control -tuote sisältää joukon sovellusliittymiä ja ohjeita laitteiden etähallintaan. Käyttäjät voivat lähettää ohjeita laitteeseen toimitettujen API-päätepisteiden avulla.

Tekniset tiedot:

Laitteen ohjaus
Versio: 20240124
Online-versio

Tuotteen käyttöohjeet

Hanki ohjesarja luokittain:
Käyttäjät voivat noutaa ohjejoukon luokittain käyttämällä seuraavia API-päätepisteitä:
- API-kuvaus
- API-osoite
- Pyyntöparametri
- Palautusparametri
- Pyydä esimample
- SDK esimample
- Vastaus esimample
- Virhekoodi
Hanki ohjesarja laitteittain:
Saadakseen laitteen ohjejoukon käyttäjät voivat käyttää tiettyjen laitteiden toimitettuja API-päätepisteitä. Tämä sisältää tietoja, kuten API-osoite, pyyntöparametrit, palautusparametrit ja esimamples.
Hanki ohjesarja laitteittain:
Tämän ominaisuuden avulla käyttäjät voivat käyttää useiden laitteiden ohjesarjaa. Käyttäjät voivat tehdä pyyntöjä käyttämällä API-osoitetta ja annettuja parametreja.
Hanki laitteen tekniset tiedot ja ominaisuudet:
Tämä API-päätepiste tarjoaa laitteen yksityiskohtaiset tiedot ja ominaisuudet, mukaan lukien käskyjoukon ja tilajoukon. Käyttäjät voivat pyytää näitä tietoja yhdessä esimampSDK:n käytöstä.
Lähetä ohjeet laitteeseen:
Käyttäjät voivat lähettää erityisiä ohjeita laitteelle mukana tulevan API:n avulla. Tämä sisältää yksityiskohtia, kuten pyyntöparametrit, palautusparametrit ja esimampkuinka lähettää ohjeet tehokkaasti.

UKK:

K: Kuinka voin tehdä vianmäärityksen, jos kohtaan virheitä ohjeiden lähettämisessä?
V: Jos kohtaat virheitä ohjeiden lähettämisessä, katso API-dokumentaation virhekoodiosio tunnistaaksesi ja tehdäksesi vianmäärityksen.
K: Voinko ohjata useita laitteita samanaikaisesti?
V: Kyllä, voit ohjata useita laitteita samanaikaisesti hyödyntämällä laiteominaisuuden antamia ohjeita ja tekemällä pyyntöjä jokaiselle laitteelle vastaavasti.

Tässä ohjeaiheessa kuvataan laiteohjaukseen liittyvät API:t, mukaan lukien ohjejoukkojen saaminen, tekniset tiedot, ominaisuudet, uusimmat tilat ja ohjeiden lähettäminen.

Hanki ohjeet luokittain

API-kuvaus
Kysy ohjejoukko luokittain. Tässä ohjesarjassa on eniten ohjeita all-in-one-sovellusten luokassa, joita kehittäjät voivat käyttää ja joihin ne voivat viitata. Jos olet alustan kehittäjä, voit kehittää sovelluksia tämän ohjesarjan mukaisesti.

API-osoite

HANKI /v1.0/-funktiot /{kategoria}

Pyydä parametria

Palautusparametri

Tuloksen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | luokka| String | Tuoteluokka |
- | toiminnot| Lista | Ohjesarja |
Toimintojen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | koodi | String | Ohje | | tyyppi | String | Ohjeen tyyppi |
- | arvot | String | Syöttöparametrien arvoalue |
- | nimi | String | Ohjeen nimi |
- | desc | String | Kuvaus |

Pyydä example

GET /v1.0/ funktioita/kg

SDK esimample

Vastaus esimample

Virhekoodi
Seuraavat ovat yleisiä palvelupoikkeuksia tälle käyttöliittymälle. Jos haluat lisätietoja poikkeusvirheistä, katso Virhekoodi.

Hanki ohjeet laitteen mukaan

API-kuvaus
Kysy laitteen tukemista toiminnoista. Voit lähettää ohjauksen saatujen ohjeiden mukaan.

API-osoite

GET /v1.0/ devices /{ device_id }/ toiminnot

Pyydä parametria

Palautusparametri

Tuloksen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | luokka| String | Tuoteluokka |
- | toiminnot| Lista | Ohjesarja |
Toimintojen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | koodi | String | Ohje |
- | tyyppi | String | Ohjetyyppi |
- | arvot | String | Syöttöparametrien arvoalue |
- | nimi | String | Ohjeen nimi |
- | desc | String | Kuvaus |

Pyydä example

GET /v1.0/ devices/vdevo155XXXX83954683/functions

SDK esimample

TuyaClient-asiakas = uusi TuyaClient(clientId , secret , RegionEnum.CN);
kategoriafunktiot = client.getFunctionsByDevId(DEV_ID);
System.out.println("Hae toimintoluettelo laitetunnuksen mukaan:");
System.out.println(JSONObject.toJSONString(luokkafunktiot));

Vastaus esimample

Virhekoodi
Seuraavat ovat yleisiä palvelupoikkeuksia tälle käyttöliittymälle. Jos haluat lisätietoja poikkeusvirheistä, katso Virhekoodi.

Hanki laitteiden ohjeet

API-kuvaus
Kysele laiteluettelon tukemista toiminnoista. Voit lähettää ohjauksen saatujen ohjeiden mukaan. tukee jopa 20 laitetta

API-osoite

GET /v1.0/ laitteet/toiminnot

Pyydä parametria

Palautusparametri

Tuloksen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | luokka| String | Tuoteluokka |
- | toiminnot| Lista | Ohjesarja |
- | laitteet | Lista | laitetunnusluettelo |
Toimintojen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | koodi | String | Ohje |
- | tyyppi | String | Ohjetyyppi |
- | arvot | String | Syöttöparametrien arvoalue |
- | nimi | String | Ohjeen nimi |
- | desc | String | Kuvaus |

Pyydä example

GET /v1.0/ devices/functions?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
a517fbc901dtln

SDK esimample

TuyaClient-asiakas = uusi TuyaClient(clientId , secret , RegionEnum.CN);
categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
System.out.println("Hae toimintoluettelo laitekohtaisesti List:");
System.out.println(JSONObject.toJSONString(luokkafunktiot));

Vastaus esimample

Virhekoodi
Seuraavat ovat yleisiä palvelupoikkeuksia tälle käyttöliittymälle. Jos haluat lisätietoja poikkeusvirheistä, katso Virhekoodi.

Laitteen tekniset tiedot ja ominaisuudet

Hanki laitteen tekniset tiedot ja ominaisuudet, mukaan lukien ohjesarja ja tilasarja

API-kuvaus
Tätä käyttöliittymää käytetään laitteen tukeman ohjesarjan ja tilajoukon saamiseen laitetunnuksen mukaan.

API-osoite

GET /v1.0/ laitteet /{ device_id }/ tekniset tiedot

Pyydä parametria

Palautusparametri

Tuloksen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | luokka | String | Tuoteluokka |
- | toiminnot | Lista | Ohjesarja |
- | tila | Lista | Tila asetettu |
Toimintojen kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :—- | :—- | :-|
- | koodi | String | komento |
- | tyyppi | String | Tyyppi |
- | arvot | String | Parametriarvojen alue |
Tilan kuvaus
- | Parametrin nimi | Luokka | Kuvaus |
- | :-| :-| :-|
- | koodi | String | tilakoodi |
- | tyyppi | String | Tyyppi |
- | arvot | String | Parametriarvojen alue |

Pyydä example

GET /v1.0/ devices/vdevoXXXXXXXXXXXXXXX/specifikaatiot

SDK esimample
Ei käytössä

Palautusparametri

Lähetä ohjeet laitteeseen

API-kuvaus
Tätä käyttöliittymää käytetään yhden tai useamman hankitun käskyjoukon lähettämiseen. Se, voidaanko ohjesarjoja lähettää samanaikaisesti, riippuu tuotteesta.

API-osoite