tuya Түзмөктү башкаруу булут кызматтарынын API шилтемеси
Продукт маалыматы
Түзмөктү башкаруу продукту API'лердин топтомун жана түзмөктөрдү алыстан башкаруу боюнча нускамаларды берет. Колдонуучулар берилген API акыркы чекиттерин колдонуу менен түзмөккө нускамаларды жөнөтө алышат.
Өзгөчөлүктөрү:
- Түзмөктү башкаруу
- Версия: 20240124
- Online котормосу
Продукт колдонуу нускамалары
- Категория боюнча нускаманы алыңыз:
Колдонуучулар төмөнкү API акыркы чекиттерин колдонуу менен категория боюнча коюлган нускаманы ала алышат:- API Description
- API дареги
- Сурам параметри
- Параметрди кайтаруу
- Сурам Example
- SDK Example
- Жооп Example
- Ката коду
- Түзмөк боюнча нускаманы алыңыз:
Түзмөк тарабынан коюлган нускаманы алуу үчүн, колдонуучулар белгилүү бир түзмөктөр үчүн берилген API акыркы чекиттерин колдоно алышат. Бул API дареги, суроо параметрлери, кайтаруу параметрлери жана мурунку сыяктуу чоо-жайды камтыйтamples. - Түзмөктөр боюнча нускаманы алыңыз:
Бул функция колдонуучуларга бир нече түзмөктөр үчүн нускама топтомуна кирүү мүмкүнчүлүгүн берет. Колдонуучулар берилген API дареги жана параметрлери аркылуу суроо-талаптарды жасай алышат. - Аппараттын спецификацияларын жана касиеттерин алыңыз:
Бул API акыркы чекити аппараттын деталдуу мүнөздөмөлөрүн жана касиеттерин, анын ичинде нускамалар топтомун жана статус топтомун камсыз кылат. Колдонуучулар бул маалыматты мурунку менен бирге сурай алышатampSDK кантип колдонуу керек. - Түзмөккө нускамаларды жөнөтүү:
Колдонуучулар берилген API аркылуу түзмөккө конкреттүү нускамаларды жөнөтө алышат. Буга суроо-талап параметрлери, кайтаруу параметрлери жана мурунку сыяктуу маалыматтар киретampнускамаларды кантип натыйжалуу жөнөтүү керек.
Көп берилүүчү суроолор:
- С: Көрсөтмөлөрдү жөнөтүүдө катачылыктарга туш болсом, көйгөйдү кантип чече алам?
Ж: Эгер нускамаларды жөнөтүүдө каталарга туш болсоңуз, көйгөйдү аныктоо жана чечүү үчүн API документтериндеги ката коду бөлүмүнө кайрылыңыз. - С: Мен бир эле учурда бир нече түзмөктү башкара аламбы?
Ж: Ооба, сиз бир эле убакта бир нече түзмөктү башкара аласыз, бул аспаптын өзгөчөлүгү тарабынан коюлган нускамаларды колдонуу жана ошого жараша ар бир түзмөк үчүн суроо-талаптарды жасоо.
Бул темада инструкциялар топтомун алуу, спецификациялар, касиеттер, акыркы статустар жана нускамаларды жөнөтүү сыяктуу түзмөктү башкаруу менен байланышкан API'лер сүрөттөлөт.
Категория боюнча белгиленген нускаманы алыңыз
API сүрөттөмөсү
Категория боюнча коюлган нускаманы сураңыз. Бул нускамалар топтому иштеп чыгуучулар тарабынан колдонула турган жана аларга кайрыла турган бардыгы бир жердеги колдонмолор категориясында эң көп нускамаларга ээ. Эгер сиз платформаны иштеп чыгуучу болсоңуз, бул нускама топтомуна ылайык тиркемелерди иштеп чыга аласыз.
API дареги
- GET /v1.0/ функциялары /{категория}
Сурам параметри
Параметрди кайтаруу
- Жыйынтыктын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | категория| String | Продукт категориясы |
- | функциялары| Тизме | Инструкциялар топтому |
- Функциялардын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | код | String | Instruction | | түрү | String | нускама түрү |
- | баалуулуктар | String | Киргизүүчү параметр маанилеринин диапазону |
- | аты | String | нускама аты |
- | desc | String | Description |
Сураныч эксample
- GET /v1.0/ functions/kg
SDK example
Жооп эксample
Ката коду
Төмөнкүлөр бул интерфейс үчүн жалпы кызмат өзгөчөлүктөр болуп саналат. Көбүрөөк өзгөчө каталар үчүн, караңыз Ката коду.
Түзмөк тарабынан коюлган нускаманы алыңыз
API сүрөттөмөсү
Түзмөк колдогон функцияларды сураңыз. Алынган нускамалар боюнча башкарууну жөнөтө аласыз.
API дареги
- GET /v1.0/ түзмөктөр /{ device_id }/ функциялары
Сурам параметри
Параметрди кайтаруу
- Жыйынтыктын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | категория| String | Продукт категориясы |
- | функциялары| Тизме | Инструкциялар топтому |
- Функциялардын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | код | String | Instruction |
- | түрү | String | нускама түрү |
- | баалуулуктар | String | Киргизүүчү параметр маанилеринин диапазону |
- | аты | String | нускама аты |
- | desc | String | Description |
Сураныч эксample
- GET /v1.0/ devices/vdevo155XXXX83954683/functions
SDK example
- TuyaClient кардары = жаңы TuyaClient(clientId , жашыруун , RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevId(DEV_ID);
- System.out.println("Функциялар тизмесин түзмөк ID боюнча алуу: ");
- System.out.println(JSONObject.toJSONString(категория Функциялары));
Жооп эксample
Ката коду
Төмөнкүлөр бул интерфейс үчүн жалпы кызмат өзгөчөлүктөр болуп саналат. Көбүрөөк өзгөчө каталар үчүн, караңыз Ката коду.
Түзмөктөр тарабынан коюлган нускаманы алыңыз
API сүрөттөмөсү
Түзмөктөр тизмеси колдоого алган функцияларды сураңыз. Алынган нускамалар боюнча башкарууну жөнөтө аласыз. 20га чейин түзмөктөрдү колдоо
API дареги
- GET /v1.0/ түзмөктөрдү/функцияларды
Сурам параметри
Параметрди кайтаруу
- Жыйынтыктын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | категория| String | Продукт категориясы |
- | функциялары| Тизме | Инструкциялар топтому |
- | аппараттар | Тизме | түзмөк ID тизмеси |
- Функциялардын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | код | String | Instruction |
- | түрү | String | нускама түрү |
- | баалуулуктар | String | Киргизүүчү параметр маанилеринин диапазону |
- | аты | String | нускама аты |
- | desc | String | Description |
Сураныч эксample
- GET /v1.0/ devices/functions?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
- a517fbc901dtln
SDK example
- TuyaClient кардары = жаңы TuyaClient(clientId , жашыруун , RegionEnum.CN);
- categoryFunctions = client.getFunctionsByDevsList(DEV_ID);
- System.out.println("Түзмөктөр тизмеси боюнча функциялар тизмесин алуу: ");
- System.out.println(JSONObject.toJSONString(категория Функциялары));
Жооп эксample
Ката коду
Төмөнкүлөр бул интерфейс үчүн жалпы кызмат өзгөчөлүктөр болуп саналат. Көбүрөөк өзгөчө каталар үчүн, караңыз Ката коду.
Аппараттын спецификациялары жана касиеттери
Аппараттын мүнөздөмөлөрүн жана касиеттерин, анын ичинде нускамалар топтомун жана статус топтомун алыңыз
API сүрөттөмөсү
Бул интерфейс аспаптын идентификаторуна ылайык аппарат тарабынан колдоого алынган нускамалар топтомун жана статус топтомун алуу үчүн колдонулат.
API дареги
- /v1.0/ түзмөктөрүн /{ device_id }/ спецификацияларын АЛУУ
Сурам параметри
Параметрди кайтаруу
- Жыйынтыктын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | категория | String | Продукт категориясы |
- | функциялары | Тизме | Инструкциялар топтому |
- | абалы | Тизме | Статус топтому |
- Функциялардын сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—- | :—- | :—|
- | код | String | команда |
- | түрү | String | Type |
- | баалуулуктар | String | Параметр маанилеринин диапазону |
- Статустун сүрөттөлүшү
- | Параметр аты | Категория | Description |
- | :—| :—| :—|
- | код | String | статус коду |
- | түрү | String | Type |
- | баалуулуктар | String | Параметр маанилеринин диапазону |
Сураныч экс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
Ката коду
Төмөнкүлөр бул интерфейс үчүн жалпы кызмат өзгөчөлүктөр болуп саналат. Көбүрөөк өзгөчө каталар үчүн, караңыз Ката коду.
Документтер / Ресурстар
 |
tuya Түзмөктү башкаруу булут кызматтарынын API шилтемеси [pdf] Колдонуучунун колдонмосу Түзмөктү башкаруу булут кызматтарынын API маалымдамасы, Cloud Services API маалымдамасы, API маалымдамасы |
