Tuya Device Control Cloud Services API Referenza
Informazzjoni dwar il-Prodott
Il-prodott tal-Kontroll tal-Apparat jipprovdi sett ta’ APIs u struzzjonijiet għall-kontroll tal-apparati mill-bogħod. L-utenti jistgħu jibagħtu struzzjonijiet lill-apparat billi jużaw l-endpoints tal-API pprovduti.
Speċifikazzjonijiet:
- Kontroll tal-Apparat
- Verżjoni: 20240124
- Verżjoni Online
Istruzzjonijiet għall-Użu tal-Prodott
- Ikseb is-Sett ta' Istruzzjonijiet skond il-Kategorija:
L-utenti jistgħu jirkupraw is-sett ta' struzzjonijiet skont il-kategorija billi jużaw l-endpoints tal-API li ġejjin:- Deskrizzjoni API
- Indirizz API
- Parametru talba
- Ritorn Parametru
- Talba Eżample
- SDK Eżample
- Rispons Eżample
- Kodiċi ta' Żball
- Ikseb is-Sett ta' Istruzzjonijiet mill-Apparat:
Biex tikseb l-istruzzjoni stabbilita mill-apparat, l-utenti jistgħu jutilizzaw l-endpoints tal-API pprovduti għal apparati speċifiċi. Dan jinkludi dettalji bħall-indirizz tal-API, il-parametri tat-talba, il-parametri tar-ritorn, u examples. - Ikseb is-Sett ta' Istruzzjonijiet mill-Apparat:
Din il-karatteristika tippermetti lill-utenti jaċċessaw is-sett ta 'struzzjonijiet għal apparati multipli. L-utenti jistgħu jagħmlu talbiet billi jużaw l-indirizz API u l-parametri pprovduti. - Ikseb l-Ispeċifikazzjonijiet u l-Proprjetajiet tal-Apparat:
Dan l-endpoint tal-API jipprovdi speċifikazzjonijiet u proprjetajiet dettaljati tal-apparat, inkluż is-sett tal-istruzzjonijiet u s-sett tal-istatus. L-utenti jistgħu jitolbu din l-informazzjoni flimkien ma examples ta' kif tuża l-SDK. - Ibgħat Istruzzjonijiet lill-Apparat:
L-utenti jistgħu jibagħtu struzzjonijiet speċifiċi lill-apparat billi jużaw l-API pprovduta. Dan jinkludi dettalji bħall-parametri tat-talba, il-parametri tar-ritorn, u examples ta' kif tibgħat l-istruzzjonijiet b'mod effettiv.
FAQ:
- Q: Kif nista' nsolvi l-problemi jekk niltaqa' ma' żbalji meta nibgħat l-istruzzjonijiet?
A: Jekk tiltaqa' ma' żbalji meta tibgħat l-istruzzjonijiet, irreferi għat-taqsima tal-kodiċi tal-iżball fid-dokumentazzjoni tal-API biex tidentifika u ssolvi l-problemi. - Q: Nista 'nikkontrolla apparati multipli simultanjament?
A: Iva, tista 'tikkontrolla apparati multipli simultanjament billi tuża l-istruzzjonijiet stabbiliti mill-karatteristika tal-apparat u tagħmel talbiet għal kull apparat kif xieraq.
Dan is-suġġett jiddeskrivi l-APIs relatati mal-kontroll tal-apparat, inkluż il-kisba ta' settijiet ta' struzzjonijiet, speċifikazzjonijiet, proprjetajiet, l-aħħar status, u struzzjonijiet li jintbagħtu.
Ikseb l-istruzzjoni stabbilita skont il-kategorija
Deskrizzjoni API
Mistoqsija l-istruzzjoni stabbilita skond il-kategorija. Dan is-sett ta 'struzzjonijiet għandu l-akbar ammont ta' struzzjonijiet fil-kategorija ta 'apps all-in-one, li jistgħu jintużaw u jirreferu għalihom l-iżviluppaturi. Jekk inti żviluppatur ta 'pjattaforma, tista' tiżviluppa applikazzjonijiet skont dan is-sett ta 'struzzjonijiet.
indirizz API
- IKOLLOK /v1.0/ funzjonijiet /{ kategorija}
Parametru talba
Parametru tar-ritorn
- Deskrizzjoni tar-riżultat
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kategorija| Spag | Kategorija tal-prodott |
- | funzjonijiet| Lista | Sett ta' struzzjonijiet |
- Deskrizzjoni tal-funzjonijiet
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kodiċi | Spag | Istruzzjoni | | tip | Spag | Tip ta' struzzjoni |
- | valuri | Spag | Il-firxa tal-valuri tal-parametri tad-dħul |
- | isem | Spag | Isem l-istruzzjoni |
- | desc | Spag | Deskrizzjoni |
Talba example
- IKOLLOK /v1.0/ funzjonijiet/kg
SDK example
Risposta example
Kodiċi ta' żball
Dawn li ġejjin huma eċċezzjonijiet tas-servizz komuni għal din l-interface. Għal aktar żbalji ta’ eċċezzjoni, ara Kodiċi ta' Żball.
Ikseb l-istruzzjoni stabbilita mill-apparat
Deskrizzjoni API
Mistoqsija l-funzjonijiet appoġġjati mill-apparat. Tista 'tibgħat kontroll mill-istruzzjonijiet miksuba.
indirizz API
- IKOLLOK /v1.0/ apparati /{ device_id }/ funzjonijiet
Parametru talba
Parametru tar-ritorn
- Deskrizzjoni tar-riżultat
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kategorija| Spag | Kategorija tal-prodott |
- | funzjonijiet| Lista | Sett ta' struzzjonijiet |
- Deskrizzjoni tal-funzjonijiet
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kodiċi | Spag | Istruzzjoni |
- | tip | Spag | Tip ta' struzzjoni |
- | valuri | Spag | Il-firxa tal-valuri tal-parametri tad-dħul |
- | isem | Spag | Isem l-istruzzjoni |
- | desc | Spag | Deskrizzjoni |
Talba example
- IKOLLOK /v1.0/ devices/vdevo155XXXX83954683/functions
SDK example
- TuyaClient client = TuyaClient ġdid (clientId , sigriet , RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevId(DEV_ID);
- System.out.println ("Ikseb il-lista tal-funzjonijiet skont l-ID tal-apparat: ");
- System.out.println(JSONObject.toJSONString(Funzjonijiet tal-kategorija));
Risposta example
Kodiċi ta' żball
Dawn li ġejjin huma eċċezzjonijiet tas-servizz komuni għal din l-interface. Għal aktar żbalji ta’ eċċezzjoni, ara Kodiċi ta' Żball.
Ikseb l-istruzzjoni stabbilita mill-apparati
Deskrizzjoni API
Mistoqsija l-funzjonijiet appoġġjati mil-Lista ta 'apparati. Tista 'tibgħat kontroll mill-istruzzjonijiet miksuba. appoġġ sa 20 apparat
indirizz API
- IKOLLOK /v1.0/ apparati/funzjonijiet
Parametru talba
Parametru tar-ritorn
- Deskrizzjoni tar-riżultat
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kategorija| Spag | Kategorija tal-prodott |
- | funzjonijiet| Lista | Sett ta' struzzjonijiet |
- | apparati | Lista | Lista tal-Id tal-apparat |
- Deskrizzjoni tal-funzjonijiet
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kodiċi | Spag | Istruzzjoni |
- | tip | Spag | Tip ta' struzzjoni |
- | valuri | Spag | Il-firxa tal-valuri tal-parametri tad-dħul |
- | isem | Spag | Isem l-istruzzjoni |
- | desc | Spag | Deskrizzjoni |
Talba example
- IKOLLOK /v1.0/ apparati/funzjonijiet?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
- a517fbc901dtln
SDK example
- TuyaClient client = TuyaClient ġdid (clientId , sigriet , RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
- System.out.println(“Ikseb il-lista tal-funzjonijiet skont il-Lista tal-apparati: “);
- System.out.println(JSONObject.toJSONString(Funzjonijiet tal-kategorija));
Risposta example
Kodiċi ta' żball
Dawn li ġejjin huma eċċezzjonijiet tas-servizz komuni għal din l-interface. Għal aktar żbalji ta’ eċċezzjoni, ara Kodiċi ta' Żball.
Speċifikazzjonijiet u proprjetajiet tal-apparat
Ikseb l-ispeċifikazzjonijiet u l-proprjetajiet tal-apparat, inkluż is-sett tal-istruzzjonijiet u s-sett tal-istatus
Deskrizzjoni API
Din l-interface tintuża biex tikseb is-sett tal-istruzzjonijiet u s-sett tal-istatus appoġġjati mill-apparat skont l-ID tal-apparat.
indirizz API
- IKOLLOK /v1.0/ apparati /{ device_id }/ speċifikazzjonijiet
Parametru talba
Parametru tar-ritorn
- Deskrizzjoni tar-riżultat
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kategorija | Spag | Kategorija tal-prodott |
- | funzjonijiet | Lista | Sett ta' struzzjonijiet |
- | status | Lista | Status stabbilit |
- Deskrizzjoni tal-funzjonijiet
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—- | :—- | :—|
- | kodiċi | Spag | kmand |
- | tip | Spag | Tip |
- | valuri | Spag | Il-firxa tal-valuri tal-parametri |
- Deskrizzjoni tal-istatus
- | Isem tal-parametru | Kategorija | Deskrizzjoni |
- | :—| :—| :—|
- | kodiċi | Spag | kodiċi tal-istatus |
- | tip | Spag | Tip |
- | valuri | Spag | Il-firxa tal-valuri tal-parametri |
Talba example
- IKOLLOK /v1.0/ devices/vdevoXXXXXXXXXXXXXXX/speċifikazzjonijiet
SDK example
N/A
Parametru tar-ritorn
Ibgħat l-istruzzjonijiet lill-apparat
Deskrizzjoni API
Din l-interface tintuża biex tibgħat sett ta 'struzzjonijiet miksub wieħed jew aktar. Jekk settijiet ta 'struzzjonijiet jistgħux jintbagħtu simultanjament jiddependi fuq il-prodott.
indirizz API
- POST /v1.0/ apparati /{ device_id }/ kmandi
Parametru talba
Parametru tar-ritorn
Talba example
- POST /v1.0/ devices/vdevo1552XXXX3954683/commands
SDK example
Risposta example
Kodiċi ta' żball
Dawn li ġejjin huma eċċezzjonijiet tas-servizz komuni għal din l-interface. Għal aktar żbalji ta’ eċċezzjoni, ara Kodiċi ta' Żball.
Ikseb l-aħħar status tal-apparat
Deskrizzjoni API
Ikseb l-aħħar status tal-apparat mill-ID tal-apparat
indirizz API
- IKOLLOK /v1.0/ apparati /{ device_id }/ status
Parametru talba
Parametru tar-ritorn
Talba example
- IKOLLOK /v1.0/ apparati /{ device_id }/ status
SDK example
Risposta example
Kodiċi ta' żball
Dawn li ġejjin huma eċċezzjonijiet tas-servizz komuni għal din l-interface. Għal aktar żbalji ta’ eċċezzjoni, ara Kodiċi ta' Żball.
Dokumenti / Riżorsi
 |
Tuya Device Control Cloud Services API Referenza [pdfGwida għall-Utent Device Control Cloud Services API Reference, Cloud Services API Reference, API Reference |
