Даведка па API воблачных службаў кіравання прыладамі
Інфармацыя аб прадукце
Прадукт Device Control забяспечвае набор API і інструкцый для дыстанцыйнага кіравання прыладамі. Карыстальнікі могуць адпраўляць інструкцыі на прыладу, выкарыстоўваючы прадастаўленыя канчатковыя кропкі API.
тэхнічныя характарыстыкі:
- Кантроль прылад
- Версія: 20240124
- электронная версія
Інструкцыя па ўжыванні прадукту
- Атрымаць набор інструкцый па катэгорыях:
Карыстальнікі могуць атрымаць набор інструкцый па катэгорыях, выкарыстоўваючы наступныя канчатковыя кропкі API:- Апісанне API
- Адрас API
- Параметр запыту
- Параметр вяртання
- Запыт Example
- SDK Example
- Адказ Example
- Код памылкі
- Атрымаць набор інструкцый па прыладзе:
Каб атрымаць інструкцыі, зададзеныя прыладай, карыстальнікі могуць выкарыстоўваць прадастаўленыя канцавыя кропкі API для пэўных прылад. Гэта ўключае ў сябе такія дэталі, як адрас API, параметры запыту, параметры вяртання і напрampлес. - Атрымаць набор інструкцый па прыладах:
Гэтая функцыя дазваляе карыстальнікам атрымліваць доступ да набору інструкцый для некалькіх прылад. Карыстальнікі могуць рабіць запыты, выкарыстоўваючы прадастаўлены адрас і параметры API. - Атрымаць тэхнічныя характарыстыкі і ўласцівасці прылады:
Гэтая канчатковая кропка API забяспечвае падрабязныя спецыфікацыі і ўласцівасці прылады, уключаючы набор інструкцый і набор статусаў. Карыстальнікі могуць запытваць гэтую інфармацыю разам з напрampпадрабязнасці аб тым, як выкарыстоўваць SDK. - Адправіць інструкцыі на прыладу:
Карыстальнікі могуць адпраўляць пэўныя інструкцыі на прыладу з дапамогай прадастаўленага API. Гэта ўключае ў сябе такія дэталі, як параметры запыту, параметры вяртання і напрampпадрабязнасці аб тым, як эфектыўна адпраўляць інструкцыі.
FAQ:
- Пытанне: Як я магу ліквідаваць непаладкі, калі я сустракаю памылкі пры адпраўцы інструкцый?
A: Калі вы сутыкнуліся з памылкамі пры адпраўцы інструкцый, звярніцеся да раздзела кодаў памылак у дакументацыі па API, каб вызначыць і ліквідаваць праблему. - Пытанне: Ці магу я кіраваць некалькімі прыладамі адначасова?
A: Так, вы можаце кіраваць некалькімі прыладамі адначасова, выкарыстоўваючы інструкцыі, устаноўленыя функцыяй прылады, і робячы адпаведныя запыты для кожнай прылады.
У гэтай тэме апісваюцца API, звязаныя з кіраваннем прыладай, уключаючы атрыманне набораў інструкцый, спецыфікацый, уласцівасцей, апошніх статусаў і адпраўку інструкцый.
Атрымайце набор інструкцый па катэгорыях
Апісанне API
Запытвайце набор інструкцый па катэгорыях. Гэты набор інструкцый змяшчае найбольшую колькасць інструкцый у катэгорыі ўніверсальных праграм, якія могуць выкарыстоўвацца і спасылацца распрацоўшчыкамі. Калі вы распрацоўшчык платформы, вы можаце распрацоўваць прыкладанні ў адпаведнасці з гэтым наборам інструкцый.
Адрас API
- GET /v1.0/ функцыі /{катэгорыя}
Параметр запыту
Параметр вяртання
- Апісанне выніку
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | катэгорыя| Радок | Катэгорыя прадукту |
- | функцыі| Спіс | Набор інструкцый |
- Апісанне функцый
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | код | Радок | Інструкцыя | | тыпу | Радок | Тып інструкцыі |
- | каштоўнасці | Радок | Дыяпазон значэнняў уваходных параметраў |
- | імя | Радок | Імя інструкцыі |
- | спуск | Радок | Апісанне |
Запыт напрample
- GET /v1.0/ функцыі/кг
SDK example
Адказ прample
Код памылкі
Ніжэй прыведзены агульныя выключэнні службы для гэтага інтэрфейсу. Каб даведацца больш пра памылкі выключэнняў, гл Код памылкі.
Атрымаць набор інструкцый для прылады
Апісанне API
Запытайце функцыі, якія падтрымліваюцца прыладай. Вы можаце адправіць кантроль па атрыманых інструкцыях.
Адрас API
- GET /v1.0/ прылады /{ device_id }/ функцыі
Параметр запыту
Параметр вяртання
- Апісанне выніку
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | катэгорыя| Радок | Катэгорыя прадукту |
- | функцыі| Спіс | Набор інструкцый |
- Апісанне функцый
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | код | Радок | Інструкцыя |
- | тыпу | Радок | Тып інструкцыі |
- | каштоўнасці | Радок | Дыяпазон значэнняў уваходных параметраў |
- | імя | Радок | Імя інструкцыі |
- | спуск | Радок | Апісанне |
Запыт напрample
- АТРЫМАЦЬ /v1.0/ devices/vdevo155XXXX83954683/functions
SDK example
- TuyaClient client = новы TuyaClient(clientId, сакрэт, RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevId(DEV_ID);
- System.out.println(“Атрымаць спіс функцый па ID прылады: “);
- System.out.println(JSONObject.toJSONString(функцыі катэгорыі));
Адказ прample
Код памылкі
Ніжэй прыведзены агульныя выключэнні службы для гэтага інтэрфейсу. Каб даведацца больш пра памылкі выключэнняў, гл Код памылкі.
Атрымлівайце набор інструкцый па прыладах
Апісанне API
Запытаць функцыі, якія падтрымліваюцца Спісам прылад. Вы можаце адправіць кантроль па атрыманых інструкцыях. падтрымка да 20 прылад
Адрас API
- АТРЫМАЦЬ /v1.0/ прылады/функцыі
Параметр запыту
Параметр вяртання
- Апісанне выніку
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | катэгорыя| Радок | Катэгорыя прадукту |
- | функцыі| Спіс | Набор інструкцый |
- | прылады | Спіс | Спіс ідэнтыфікатараў прылады |
- Апісанне функцый
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | код | Радок | Інструкцыя |
- | тыпу | Радок | Тып інструкцыі |
- | каштоўнасці | Радок | Дыяпазон значэнняў уваходных параметраў |
- | імя | Радок | Імя інструкцыі |
- | спуск | Радок | Апісанне |
Запыт напрample
- АТРЫМАЦЬ /v1.0/ devices/functions?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
- a517fbc901dtln
SDK example
- TuyaClient client = новы TuyaClient(clientId, сакрэт, RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
- System.out.println(“Атрымаць спіс функцый па спісе прылад: “);
- System.out.println(JSONObject.toJSONString(функцыі катэгорыі));
Адказ прample
Код памылкі
Ніжэй прыведзены агульныя выключэнні службы для гэтага інтэрфейсу. Каб даведацца больш пра памылкі выключэнняў, гл Код памылкі.
Тэхнічныя характарыстыкі і ўласцівасці прылады
Атрымайце спецыфікацыі і ўласцівасці прылады, уключаючы набор інструкцый і набор статусаў
Апісанне API
Гэты інтэрфейс выкарыстоўваецца для атрымання набору інструкцый і набору стану, які падтрымліваецца прыладай, у адпаведнасці з ідэнтыфікатарам прылады.
Адрас API
- АТРЫМАЦЬ /v1.0/ прылады /{ device_id }/ спецыфікацыі
Параметр запыту
Параметр вяртання
- Апісанне выніку
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | катэгорыя | Радок | Катэгорыя прадукту |
- | функцыі | Спіс | Набор інструкцый |
- | статус | Спіс | Статус усталяваны |
- Апісанне функцый
- | Імя параметра | Катэгорыя | Апісанне |
- | :—- | :—- | :—|
- | код | Радок | каманда |
- | тыпу | Радок | Тып |
- | каштоўнасці | Радок | Дыяпазон значэнняў параметраў |
- Апісанне стану
- | Імя параметра | Катэгорыя | Апісанне |
- | :—| :—| :—|
- | код | Радок | код стану |
- | тыпу | Радок | Тып |
- | каштоўнасці | Радок | Дыяпазон значэнняў параметраў |
Запыт напрample
- АТРЫМАЦЬ /v1.0/ devices/vdevoXXXXXXXXXXXXXXX/specifications
SDK example
Н/Д
Параметр вяртання
Адправіць інструкцыі на прыладу
Апісанне API
Гэты інтэрфейс выкарыстоўваецца для адпраўкі аднаго або некалькіх атрыманых набораў інструкцый. Магчымасць адпраўкі набораў інструкцый адначасова залежыць ад прадукту.
Адрас API
- POST /v1.0/ прылады /{ device_id }/ каманды
Параметр запыту
Параметр вяртання
Запыт напрample
- POST /v1.0/ devices/vdevo1552XXXX3954683/commands
SDK example
Адказ прample
Код памылкі
Ніжэй прыведзены агульныя выключэнні службы для гэтага інтэрфейсу. Каб даведацца больш пра памылкі выключэнняў, гл Код памылкі.
Атрымаць апошнюю інфармацыю аб стане прылады
Апісанне API
Атрымлівайце апошні стан прылады па ідэнтыфікатары прылады
Адрас API
- АТРЫМАЦЬ /v1.0/ прылады /{ device_id }/ статус
Параметр запыту
Параметр вяртання
Запыт напрample
- АТРЫМАЦЬ /v1.0/ прылады /{ device_id }/ статус
SDK example
Адказ прample
Код памылкі
Ніжэй прыведзены агульныя выключэнні службы для гэтага інтэрфейсу. Каб даведацца больш пра памылкі выключэнняў, гл Код памылкі.
Дакументы / Рэсурсы
 | Даведнік па API воблачных службаў кіравання прыладамі |
Спасылкі
- Кіраўніцтва карыстальнікаmanual.tools