Tuya Device Control Cloud Services API Reference

Impormasyon sa Produkto
Ang produkto sa Device Control naghatag og usa ka set sa mga API ug mga instruksyon alang sa pagkontrol sa mga device sa layo. Ang mga tiggamit mahimo’g magpadala mga panudlo sa aparato gamit ang gihatag nga mga endpoint sa API.
Mga detalye:
- Pagkontrol sa Device
- Bersyon: 20240124
- Online nga Bersyon
Mga Instruksyon sa Paggamit sa Produkto
- Kuhaa ang Instruksyon nga Set sa Kategorya:
Mahimo makuha sa mga tiggamit ang panudlo nga gitakda sa kategorya gamit ang mga mosunud nga mga endpoint sa API:- Deskripsyon sa API
- Address sa API
- Parameter sa Paghangyo
- Ibalik ang Parameter
- Hangyo Example
- SDK Example
- Tubag Example
- Error Code
- Kuhaa ang Instruksyon nga Set sa Device:
Aron makuha ang panudlo nga gitakda sa aparato, ang mga tiggamit mahimong mogamit sa gihatag nga mga endpoint sa API alang sa piho nga mga aparato. Naglakip kini sa mga detalye sama sa adres sa API, mga parameter sa paghangyo, mga parameter sa pagbalik, ug examples. - Kuhaa ang Instruksyon nga Set sa mga Device:
Kini nga bahin nagtugot sa mga tiggamit sa pag-access sa set sa panudlo alang sa daghang mga aparato. Ang mga tiggamit makahimo og mga hangyo gamit ang API address ug mga parameter nga gihatag. - Kuhaa ang mga Detalye ug Properties sa Device:
Kini nga endpoint sa API naghatag ug detalyado nga mga detalye ug mga kabtangan sa aparato, lakip ang set sa panudlo ug set sa kahimtang. Ang mga tiggamit makahangyo niini nga impormasyon uban sa exampunsaon paggamit ang SDK. - Ipadala ang mga Instruksyon sa Device:
Ang mga tiggamit mahimong magpadala ug piho nga mga panudlo sa aparato gamit ang gihatag nga API. Naglakip kini sa mga detalye sama sa mga parameter sa paghangyo, mga parameter sa pagbalik, ug examples kon unsaon pagpadala sa mga instruksiyon sa epektibong paagi.
FAQ:
- P: Unsaon nako pag-troubleshoot kung makasugat ko og mga sayop sa pagpadala sa mga instruksyon?
A: Kung makasugat ka og mga sayup sa pagpadala sa mga panudlo, tan-awa ang seksyon sa error code sa dokumentasyon sa API aron mahibal-an ug masulbad ang isyu. - P: Mahimo ba nako makontrol ang daghang mga aparato nga dungan?
A: Oo, mahimo nimong kontrolon ang daghang mga aparato nga dungan pinaagi sa paggamit sa mga panudlo nga gitakda sa bahin sa aparato ug paghimo mga hangyo alang sa matag aparato sumala niana.
Kini nga hilisgutan naghulagway sa mga API nga may kalabutan sa pagkontrol sa device, lakip ang pagkuha sa mga set sa instruksiyon, mga detalye, mga kabtangan, ang pinakabag-o nga mga status, ug pagpadala sa mga instruksyon.

Kuhaa ang panudlo nga gitakda sa kategorya
Deskripsyon sa API
Pangutana ang panudlo nga gitakda sa kategorya. Kini nga set sa instruksiyon adunay labing kadaghan nga instruksyon sa kategorya sa tanan-sa-usa nga mga app, nga magamit ug i-refer sa mga developer. Kung ikaw usa ka developer sa plataporma, mahimo nimong mapalambo ang mga aplikasyon sumala sa kini nga set sa panudlo.
API address
- GET /v1.0/ functions /{category}
Pangayo nga parametro

Ibalik ang parameter


- Deskripsyon sa resulta
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kategoriya| Sting | Kategoriya sa produkto |
- | mga gimbuhaton| Listahan | Instruksyon set |
- Deskripsyon sa mga gimbuhaton
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kodigo | Sting | Instruksyon | | tipo | Sting | Uri sa panudlo |
- | bili | Sting | Ang han-ay sa input parameter values |
- | ngalan | Sting | Ngalan sa instruksiyon |
- | desc | Sting | Deskripsyon |
Nangayo example
- GET /v1.0/ functions/kg
SDK example

Tubag example

Error code
Ang mosunod mao ang kasagarang mga eksepsiyon sa serbisyo alang niini nga interface. Alang sa dugang nga mga sayop nga eksepsiyon, tan-awa Error Code.

Kuhaa ang panudlo nga gitakda sa aparato
Deskripsyon sa API
Pangutan-a ang mga gimbuhaton nga gisuportahan sa aparato. Mahimo nimong ipadala ang kontrol pinaagi sa nakuha nga mga panudlo.
API address
- GET /v1.0/ device /{ device_id }/ functions
Pangayo nga parametro

Ibalik ang parameter


- Deskripsyon sa resulta
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kategoriya| Sting | Kategoriya sa produkto |
- | mga gimbuhaton| Listahan | Instruksyon set |
- Deskripsyon sa mga gimbuhaton
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kodigo | Sting | Instruksyon |
- | tipo | Sting | Uri sa panudlo |
- | bili | Sting | Ang han-ay sa input parameter values |
- | ngalan | Sting | Ngalan sa instruksiyon |
- | desc | Sting | Deskripsyon |
Nangayo example
- GET /v1.0/ devices/vdevo155XXXX83954683/functions
SDK example
- TuyaClient client = bag-ong TuyaClient(clientId , sekreto , RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevId(DEV_ID);
- System.out.println("Kuhaa ang lista sa function pinaagi sa device ID: ");
- System.out.println(JSONObject.toJSONString(category Functions));
Tubag example

Error code
Ang mosunod mao ang kasagarang mga eksepsiyon sa serbisyo alang niini nga interface. Alang sa dugang nga mga sayop nga eksepsiyon, tan-awa Error Code.

Kuhaa ang panudlo nga gitakda sa mga aparato
Deskripsyon sa API
Pangutana ang mga gimbuhaton nga gisuportahan sa Lista sa mga aparato. Mahimo nimong ipadala ang kontrol pinaagi sa nakuha nga mga panudlo. suporta hangtod sa 20 nga mga aparato
API address
- GET /v1.0/ device/functions
Pangayo nga parametro

Ibalik ang parameter


- Deskripsyon sa resulta
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kategoriya| Sting | Kategoriya sa produkto |
- | mga gimbuhaton| Listahan | Instruksyon set |
- | kahimanan | Listahan | Listahan sa ID sa device |
- Deskripsyon sa mga gimbuhaton
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kodigo | Sting | Instruksyon |
- | tipo | Sting | Uri sa panudlo |
- | bili | Sting | Ang han-ay sa input parameter values |
- | ngalan | Sting | Ngalan sa instruksiyon |
- | desc | Sting | Deskripsyon |
Nangayo example
- GET /v1.0/ devices/functions?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
- a517fbc901dtln
SDK example
- TuyaClient client = bag-ong TuyaClient(clientId , sekreto , RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
- System.out.println("Kuhaa ang lista sa function pinaagi sa Lista sa mga device: ");
- System.out.println(JSONObject.toJSONString(category Functions));
Tubag example

Error code
Ang mosunod mao ang kasagarang mga eksepsiyon sa serbisyo alang niini nga interface. Alang sa dugang nga mga sayop nga eksepsiyon, tan-awa Error Code.

Mga detalye ug kabtangan sa aparato
Kuhaa ang mga detalye ug mga kabtangan sa aparato, lakip ang set sa panudlo ug set sa kahimtang
Deskripsyon sa API
Kini nga interface gigamit aron makuha ang set sa panudlo ug set sa kahimtang nga gisuportahan sa aparato sumala sa ID sa aparato.
API address
- GET /v1.0/ devices /{ device_id }/ specifications
Pangayo nga parametro

Ibalik ang parameter


- Deskripsyon sa resulta
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kategoriya | Sting | Kategoriya sa produkto |
- | mga gimbuhaton | Listahan | Instruksyon set |
- | kahimtang | Listahan | Gitakda ang kahimtang |
- Deskripsyon sa mga gimbuhaton
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—- | :—- | :—|
- | kodigo | Sting | sugo |
- | tipo | Sting | Type |
- | bili | Sting | Ang sakup sa mga bili sa parameter |
- Deskripsyon sa kahimtang
- | Ngalan sa parameter | Kategoriya | Deskripsyon |
- | :—| :—| :—|
- | kodigo | Sting | status code |
- | tipo | Sting | Type |
- | bili | Sting | Ang sakup sa mga bili sa parameter |
Nangayo example
- GET /v1.0/ mga himan/vdevoXXXXXXXXXXXXXXX/mga espesipikasyon
SDK example
N/A
Ibalik ang parameter

Ipadala ang mga instruksyon sa device
Deskripsyon sa API
Kini nga interface gigamit sa pagpadala sa usa o daghan pa nga nakuha nga mga set sa panudlo. Kung ang mga set sa panudlo mahimong ipadala nga dungan depende sa produkto.
API address
- POST /v1.0/ device /{ device_id }/ mga sugo
Pangayo nga parametro

Ibalik ang parameter


Nangayo example
- POST /v1.0/ mga himan/vdevo1552XXXX3954683/mga sugo

SDK example

Tubag example

Error code
Ang mosunod mao ang kasagarang mga eksepsiyon sa serbisyo alang niini nga interface. Alang sa dugang nga mga sayop nga eksepsiyon, tan-awa Error Code.

Kuhaa ang pinakabag-o nga status sa device
Deskripsyon sa API
Kuhaa ang pinakabag-o nga status sa device pinaagi sa device ID
API address
- GET /v1.0/ device /{ device_id }/ status
Pangayo nga parametro

Ibalik ang parameter


Nangayo example
- GET /v1.0/ device /{ device_id }/ status
SDK example

Tubag example


Error code
Ang mosunod mao ang kasagarang mga eksepsiyon sa serbisyo alang niini nga interface. Alang sa dugang nga mga sayop nga eksepsiyon, tan-awa Error Code.

Mga Dokumento / Mga Kapanguhaan
![]() |
Tuya Device Control Cloud Services API Reference [pdf] Giya sa Gumagamit Pagkontrol sa Device sa Cloud Services API Reference, Cloud Services API Reference, API Reference |





