tuya Device Control Cloud Services API Reference User Guide

tuya Cihaz İdarəetmə Bulud Xidmətləri API Referansı

Məhsul haqqında məlumat

Cihaz İdarəetmə məhsulu cihazları uzaqdan idarə etmək üçün bir sıra API və təlimatlar təqdim edir. İstifadəçilər verilmiş API son nöqtələrindən istifadə edərək cihaza təlimatlar göndərə bilərlər.

Xüsusiyyətlər:

Cihaza Nəzarət
Versiya: 20240124
Online versiya

Məhsuldan İstifadə Təlimatları

Kateqoriyaya görə təlimat dəstini əldə edin:
İstifadəçilər aşağıdakı API son nöqtələrindən istifadə edərək kateqoriya üzrə təyin edilmiş təlimatı əldə edə bilərlər:
- API Təsviri
- API ünvanı
- Sorğu Parametri
- Qayıdış Parametri
- Sorğu Example
- SDK Example
- Cavab Example
- Səhv kodu
Cihaz tərəfindən Təlimat dəstini əldə edin:
Cihaz tərəfindən təyin edilmiş təlimatı əldə etmək üçün istifadəçilər xüsusi cihazlar üçün təqdim edilmiş API son nöqtələrindən istifadə edə bilərlər. Buraya API ünvanı, sorğu parametrləri, qaytarma parametrləri və s. kimi təfərrüatlar daxildiramples.
Cihazlar üzrə Təlimat Dəstini əldə edin:
Bu funksiya istifadəçilərə bir neçə cihaz üçün təlimat dəstinə daxil olmaq imkanı verir. İstifadəçilər verilmiş API ünvanından və parametrlərdən istifadə edərək sorğu verə bilərlər.
Cihazın texniki xüsusiyyətlərini və xüsusiyyətlərini əldə edin:
Bu API son nöqtəsi təlimat dəsti və status dəsti daxil olmaqla cihazın ətraflı spesifikasiyalarını və xüsusiyyətlərini təmin edir. İstifadəçilər bu məlumatı exampSDK-dan necə istifadə edəcəyinizi öyrənin.
Təlimatları cihaza göndərin:
İstifadəçilər təqdim edilmiş API-dən istifadə edərək cihaza xüsusi təlimatlar göndərə bilərlər. Buraya sorğu parametrləri, qaytarma parametrləri və s. kimi təfərrüatlar daxildirampTəlimatları effektiv şəkildə necə göndərmək olar.

Tez-tez verilən suallar:

S: Təlimatları göndərərkən xətalarla qarşılaşsam, problemləri necə həll edə bilərəm?
A: Təlimatları göndərərkən xətalarla qarşılaşsanız, problemi müəyyən etmək və həll etmək üçün API sənədlərindəki xəta kodu bölməsinə baxın.
S: Birdən çox cihazı eyni vaxtda idarə edə bilərəmmi?
Cavab: Bəli, siz cihaz funksiyasının təyin etdiyi təlimatlardan istifadə etməklə və hər bir cihaz üçün müvafiq sorğular etməklə eyni vaxtda birdən çox cihazı idarə edə bilərsiniz.

Bu mövzu təlimat dəstlərinin, spesifikasiyaların, xassələrin, ən son statusların alınması və təlimatların göndərilməsi daxil olmaqla, cihaz nəzarəti ilə bağlı API-ləri təsvir edir.

Kateqoriyaya görə təyin edilmiş təlimatı əldə edin

API təsviri
Təlimatı kateqoriyaya görə sorğulayın. Bu təlimat dəsti, tərtibatçılar tərəfindən istifadə edilə və istinad edilə bilən, hamısı bir yerdə tətbiqlər kateqoriyasında ən çox təlimatlara malikdir. Əgər siz platforma tərtibatçısınızsa, bu təlimat dəstinə uyğun olaraq proqramlar hazırlaya bilərsiniz.

API ünvanı

GET /v1.0/ funksiyaları /{kateqoriya}

Sorğu parametri

Qayıdış parametri

Nəticənin təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kateqoriya| String | Məhsul kateqoriyası |
- | funksiyaları| Siyahı | Təlimat dəsti |
Funksiyaların təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kod | String | Təlimat | | növü | String | Təlimat növü |
- | dəyərlər | String | Giriş parametri dəyərlərinin diapazonu |
- | ad | String | Təlimat adı |
- | desc | String | Təsvir |

Sorğu məsələnample

GET /v1.0/ funksiyaları/kq

SDK məsələnample

Cavab example

Xəta kodu
Aşağıdakılar bu interfeys üçün ümumi xidmət istisnalarıdır. Daha çox istisna səhvləri üçün baxın Səhv kodu.

Cihaz tərəfindən təyin edilmiş təlimatı alın

API təsviri
Cihaz tərəfindən dəstəklənən funksiyaları sorğulayın. Əldə edilmiş təlimatlarla nəzarəti göndərə bilərsiniz.

API ünvanı

GET /v1.0/ cihazlar /{ device_id }/ funksiyaları

Sorğu parametri

Qayıdış parametri

Nəticənin təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kateqoriya| String | Məhsul kateqoriyası |
- | funksiyaları| Siyahı | Təlimat dəsti |
Funksiyaların təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kod | String | Təlimat |
- | növü | String | Təlimat növü |
- | dəyərlər | String | Giriş parametri dəyərlərinin diapazonu |
- | ad | String | Təlimat adı |
- | desc | String | Təsvir |

Sorğu məsələnample

GET /v1.0/ devices/vdevo155XXXX83954683/funksiyalar

SDK məsələnample

TuyaClient müştəri = yeni TuyaClient(clientId , gizli , RegionEnum.CN);
kateqoriyaFunctions = client.getFunctionsByDevId(DEV_ID);
System.out.println(“Cihaz ID-si ilə funksiya siyahısını əldə edin: “);
System.out.println(JSONObject.toJSONString(kateqoriya Funksiyaları));

Cavab example

Xəta kodu
Aşağıdakılar bu interfeys üçün ümumi xidmət istisnalarıdır. Daha çox istisna səhvləri üçün baxın Səhv kodu.

Cihazlar tərəfindən təyin edilmiş təlimatı alın

API təsviri
Cihazlar Siyahısı tərəfindən dəstəklənən funksiyaları sorğulayın. Əldə edilmiş təlimatlarla nəzarəti göndərə bilərsiniz. 20-yə qədər cihazı dəstəkləyir

API ünvanı

GET /v1.0/ cihazlar/funksiyalar

Sorğu parametri

Qayıdış parametri

Nəticənin təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kateqoriya| String | Məhsul kateqoriyası |
- | funksiyaları| Siyahı | Təlimat dəsti |
- | cihazlar | Siyahı | cihaz İD Siyahısı |
Funksiyaların təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kod | String | Təlimat |
- | növü | String | Təlimat növü |
- | dəyərlər | String | Giriş parametri dəyərlərinin diapazonu |
- | ad | String | Təlimat adı |
- | desc | String | Təsvir |

Sorğu məsələnample

GET /v1.0/ cihazlar/funksiyalar?device_ids =06200286 dc4f22c8418c ,6c8b eb2f
a517fbc901dtln

SDK məsələnample

TuyaClient müştəri = yeni TuyaClient(clientId , gizli , RegionEnum.CN);
kateqoriyaFunctions = client.getFunctionsByDevsList(DEV_ID);
System.out.println("Funksiya siyahısını cihazlar siyahısına görə əldə edin: ");
System.out.println(JSONObject.toJSONString(kateqoriya Funksiyaları));

Cavab example

Xəta kodu
Aşağıdakılar bu interfeys üçün ümumi xidmət istisnalarıdır. Daha çox istisna səhvləri üçün baxın Səhv kodu.

Cihazın texniki xüsusiyyətləri və xüsusiyyətləri

Təlimat dəsti və status dəsti daxil olmaqla cihazın spesifikasiyalarını və xüsusiyyətlərini əldə edin

API təsviri
Bu interfeys cihaz ID-sinə uyğun olaraq cihaz tərəfindən dəstəklənən təlimat dəstini və status dəstini əldə etmək üçün istifadə olunur.

API ünvanı

/v1.0/ cihazlar /{ device_id }/ spesifikasiyalar GET

Sorğu parametri

Qayıdış parametri

Nəticənin təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kateqoriya | String | Məhsul kateqoriyası |
- | funksiyaları | Siyahı | Təlimat dəsti |
- | status | Siyahı | Status seti |
Funksiyaların təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—- | :—- | :—|
- | kod | String | əmr |
- | növü | String | Növ |
- | dəyərlər | String | Parametr dəyərlərinin diapazonu |
Statusun təsviri
- | Parametr adı | Kateqoriya | Təsvir |
- | :—| :—| :—|
- | kod | String | status kodu |
- | növü | String | Növ |
- | dəyərlər | String | Parametr dəyərlərinin diapazonu |

Sorğu məsələnample

/v1.0/cihazlar/vdevoXXXXXXXXXXXXXXX/spesifikasiyaları ƏLDƏ EDİN

SDK məsələnample
Yoxdur

Qayıdış parametri

Təlimatları cihaza göndərin

API təsviri
Bu interfeys bir və ya bir neçə əldə edilmiş təlimat dəstini göndərmək üçün istifadə olunur. Təlimat dəstlərinin eyni vaxtda göndərilə biləcəyi məhsuldan asılıdır.

API ünvanı