AsyncRRpc - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bu işlemi, IoT Platform'dan MQTT (MQTT ağ geçitleri dahil) veya GB/T 32960 ağ geçidi üzerinden bağlanan bir cihaza mesaj göndermek için çağırabilirsiniz.

QPS sınırları

Bu işlemi hesap başına saniyede en fazla 1.000 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. Bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. Ayrıca farklı SDK'ler için örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	AsyncRRpc	Gerçekleştirmek istediğiniz işlem. Değeri AsyncRRpc olarak ayarlayın.
DeviceName	String	Evet	device1	Mesajı göndermek istediğiniz cihazın DeviceName değeri.
ProductKey	String	Evet	aldfeSe****	Cihazın ait olduğu ürünün ProductKey değeri.
MessageContent	String	Evet	eyJ0ZXN0IjoidGFzayBwdWIgYnJvYWRjYXN0In0=	Yayımlanacak mesajın gövdesi. Ham mesajı ikili verilere dönüştürün ve ardından Base64 ile kodlayın. Not IoT Platform, mesajı cihaza göndermeden önce Base64 ile kodlanmış verilerin kodunu çözer; bu nedenle cihazın Base64 kod çözme işlemi yapması gerekmez.
TopicFullName	String	Hayır	/a1uZfYb**/A_Vol**/user/update	Cihazın özel konusu. MQTT üzerinden bağlanan bir cihaza mesaj gönderirken gereklidir. Cihazın konuda Subscribe veya Publish and Subscribe iznine sahip olması gerekir. GB/T 32960 ağ geçidi üzerinden bağlanan cihazlar için gerekli değildir.
ExtInfo	String	Hayır	{"commandType": 128}	Mesajdaki komut türü. GB/T 32960 ağ geçidi üzerinden bağlanan bir cihaza mesaj gönderirken gereklidir. Geçerli değerler: 128: sorgu komutu (0x80). 129: yapılandırma komutu (0x81). 130: araç cihazlarında kontrol komutu (0x82). GB/T 32960 ağ geçidi üzerinden bir cihaz bağlama hakkında daha fazla bilgi için bkz. GB/T 32960 gateways.
IotInstanceId	String	Hayır	iot-v64********	Örnek kimliği. IoT Platform konsolundaki Overview sayfasında ID değerini bulabilirsiniz. Önemli Örneğinizin bir ID değeri varsa, bu parametre için ID'yi belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. Overview sayfası görüntülenmiyorsa veya örneğinizin bir ID değeri yoksa bu parametreyi belirtmenize gerek yoktur. Daha fazla bilgi için bkz. Overview.

Yukarıda listelenen işleme özel parametrelere ek olarak, ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Common parameters.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.device.InvalidFormattedDeviceName	İstek başarısız olursa döndürülen hata kodu. Daha fazla bilgi için Error codes bölümüne bakın.
ErrorMessage	String	The format of DeviceName is invalid.	İstek başarısız olursa döndürülen hata mesajı.
MessageId	Long	889455942124347392	Mesaj gönderildiğinde IoT Platform tarafından oluşturulan mesaj kimliği.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	İstek kimliği.
Success	Boolean	true	İsteğin başarılı olup olmadığını gösterir. Geçerli değerler: true false

Örnekler

Örnek istekler

https://iot.cn-shanghai.aliyuncs.com/?Action=AsyncRRpc
&DeviceName=device1
&MessageContent=dGhpcyBpcyBhbiBleGFtcGxl
&ProductKey=aldfeSe****
&IotInstanceId=iot-v64********
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

<AsyncRRpcResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <Success>true</Success>
  <MessageId>889455942124347400</MessageId>
</AsyncRRpcResponse>

JSON biçimi

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "Success": true,
    "MessageId": 889455942124347400
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	iot.prod.NullProductKey	The ProductKey is empty.	ProductKey boş bırakılmış.
400	iot.prod.InvalidFormattedProductkey	The ProductKey format is incorrect.	ProductKey parametresinin değeri geçersiz.
400	iot.device.NullDeviceName	The deviceName is empty.	DeviceName boş bırakılmış.
400	iot.device.InvalidFormattedDeviceName	The deviceName format is incorrect.	DeviceName biçimi geçersiz.
400	iot.device.InactiveDevice	The device is inactive.	Cihaz etkinleştirilmemiş; yani cihaz IoT Platform'a hiç bağlanmamış.
400	iot.device.OfflineDevice	The device is offline.	Cihazın bağlantısı kesilmiş.
400	iot.Device.NotExistedDevice	This device does not exist.	Cihaz mevcut değil veya etkinleştirilmemiş.

Hata kodlarının listesi için bkz. Service error codes.