InvokeThingsService - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Birden fazla cihaz hizmetini aynı anda çağırır.

Kullanım notları

Bu işlem yalnızca eşzamansız olarak çağrılabilir.

Cihaz hizmet çağrısını aldığında, hizmeti çağıran tarafa bir yanıt döndürür. Cihazı yapılandırırken yanıt mantığını ve yanıt parametrelerini belirtmelisiniz. Yanıt parametrelerinin veri biçimleri Alink protokolüne uygun olmalıdır. Örnek:


{
    "id": "58***89",
    "code": 200,
    "data": {},
    "message": "success",
    "localizedMsg": "localizedMsg"
}

Not

id parametresi isteğin benzersiz tanımlayıcısını belirtir. Kimlik IoT Platform tarafından oluşturulur. Cihaz bu kimliği istek parametrelerinden alıp geri döndürebilir.
code parametresi hizmet çağrısının sonucunu belirtir. Değer bir tamsayıdır.
data parametresi hizmet çağrısının sonucunu gösterir. Bu parametre hizmeti çağıran tarafa döndürülür. Döndürülen sonuçta yer alacak parametreleri siz belirleyebilirsiniz. Veriler JSON biçiminde olmalıdır.
message ve localizedMsg parametreleri isteğe bağlıdır.

IoT Platform'un C dili için Link SDK'sı Thing Specification Language (TSL) modelinin nasıl kullanılacağına dair bir örnek sunar. Daha fazla bilgi için bkz. Cihaz hizmetlerini çağırma.

QPS sınırları

Bu API işlemini hesap başına saniyede en fazla 10 kez çağırabilirsiniz.

Not

Bir Alibaba Cloud hesabının RAM kullanıcıları hesabın kotasını paylaşır.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer farklı SDK'lar için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	InvokeThingsService	Gerçekleştirmek istediğiniz işlem. Değeri InvokeThingsService olarak ayarlayın.
Args	String	Yes	{"param1":1}	Hizmetin giriş parametresi. Değer bir JSON dizesidir. Örnek: Args={"param1": 1}. Hizmet için bir giriş parametresi yapılandırmak istemiyorsanız değeri Args={} olarak ayarlayın. Önemli TSL verileri float veya double türündeyse TSL verilerine karşılık gelen parametre değerleri en az bir ondalık basamak içermelidir. Örnekler: 10,0 ve 11,1.
DeviceName.N	RepeatList	Yes	device1	Hizmeti çağrılan cihazın adı. En fazla 100 cihaz adı belirtebilirsiniz.
Identifier	String	Yes	Set	Hizmetin tanımlayıcısı. Hizmetin identifier değerini görüntülemek için aşağıdaki yöntemlerden birini kullanabilirsiniz: IoT Platform konsolunda oturum açın. Cihazın ait olduğu ürünün Define Feature sekmesinde tanımlayıcıyı görüntüleyebilirsiniz. QueryThingModel işlemini çağırın ve döndürülen TSL bilgilerinde tanımlayıcıyı görüntüleyin. Not testFb adlı özel bir modüle ait testFb:testService adlı bir hizmet varsa bu parametreyi testFb:testService olarak ayarlayabilirsiniz. Özel modül varsayılan modül değildir.
ProductKey	String	Yes	a1BwAGV****	Cihazın ait olduğu ürünün ProductKey değeri.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	IoT örneğinin ID değeri. Örneğin ID değerini IoT Platform konsolundaki Overview sayfasında görüntüleyebilirsiniz. Önemli Örneğinizin bir ID değeri varsa bu parametre için ID değerini belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. Örneğiniz için bir Overview sayfası veya ID değeri oluşturulmamışsa bu parametreyi yapılandırmanız gerekmez. Daha fazla bilgi için bkz. Instance overview.
Qos	Integer	No	1	Mesajın hizmet kalitesi (QoS) düzeyi. Geçerli değerler: 0 (varsayılan): Sistem mesajı en fazla bir kez gönderir. 1: Sistem mesajı en az bir kez gönderir. QoS 1 mesajı yayınladıktan sonra bir PUBACK yanıtı alınmazsa cihaz IoT Platform'a yeniden bağlandığında mesaj cihaza tekrar gönderilir.

Yukarıdaki işleme özgü istek parametrelerine ek olarak bu işlemi çağırırken ortak istek parametrelerini de yapılandırmanız gerekir. Daha fazla bilgi için bkz. Ortak parametreler.

Yanıt parametreleri

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Çağrı başarısız olursa döndürülen hata kodu. Hata kodları hakkında daha fazla bilgi için bkz. Hata kodları.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	İsteğin ID değeri.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. Geçerli değerler: true: Çağrı başarılı oldu. Ancak bu sonuç hizmetin çalıştırıldığını göstermez. Çalıştırma sonucunu almak için cihaz günlüklerini görüntüleyin. false: Çağrı başarısız oldu.

Örnekler

Örnek istekler

https://iot.cn-shanghai.aliyuncs.com/?Action=InvokeThingsService
&Args=%7B%20%20%20%20%20%22walk%22%3A%22a~z%22%2C%20%20%20%20%20%22city%22%3A%22shanghai%22%20%7D
&DeviceName.1=1102andriod02
&DeviceName.2=1102android01
&Identifier=TimeReset
&ProductKey=a1hWjHD****
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

<InvokeThingsServiceResponse>
  <RequestId>059C3274-6197-4BEC-95E4-49A076330E57</RequestId>
  <Success>true</Success>
</InvokeThingsServiceResponse>

JSON biçimi

{
  "RequestId": "059C3274-6197-4BEC-95E4-49A076330E57",
  "Success": true
}

Hata kodları

Hata kodlarının listesi için bkz. Hizmet hata kodları.