RRpc - Envoyer une requête synchrone à un appareil IoT - IoT Platform

Remarques d'utilisation

Si l'appareil ne répond pas dans le délai spécifié par le paramètre Timeout, IoT Platform considère l'appel comme ayant échoué, même si l'appareil a reçu le message.

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 1 000 fois par seconde par compte.

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota du compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Vous pouvez appeler cette opération dans OpenAPI Explorer pour générer automatiquement des exemples de code SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	RRpc	L'opération à effectuer. Définissez la valeur sur RRpc.
ProductKey	String	Yes	aldfeSe****	Le ProductKey du produit auquel appartient l'appareil.
DeviceName	String	Yes	device1	Le DeviceName de l'appareil cible.
RequestBase64Byte	String	Yes	dGhpcyBpcyBhbiBleGFtcGxl	Le corps du message à envoyer. Convertissez le message brut en données binaires, puis encodez-le en Base64. Remarque IoT Platform décode les données en Base64 avant de les transférer à l'appareil. L'appareil reçoit directement le message brut.
Timeout	Integer	Yes	1000	Le délai d'attente de la réponse, en millisecondes. Valeurs valides : 1000 à 8000.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	L'ID d'instance. Consultez l'ID sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez le spécifier. Sinon, l'appel échouera. Si la page Overview ne s'affiche pas ou si votre instance n'a pas d'ID, ignorez ce paramètre. Overview.
Topic	String	No	/a1uZfYb**/A_Vol**/user/update	Le topic RRPC personnalisé. Configurez l'appareil avant d'utiliser un topic personnalisé. Utiliser des topics personnalisés. Si non spécifié, le topic RRPC par défaut est utilisé.
ContentType	String	No	240	Le type de message JT/T 808 envoyé du serveur à l'appareil. Valeurs valides : 0 : Données du module GNSS. 11 : Données de carte IC pour les permis de transport routier. 65 : Données de transmission directe du port série 1. 66 : Données de transmission directe du port série 2. 240 à 255 : Données de transmission directe personnalisées. Passerelles JT/T 808.

Cette opération nécessite également des paramètres de requête communs. Paramètres communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Le code d'erreur renvoyé en cas d'échec de l'appel. Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
MessageId	Long	889455942124347392	L'ID du message généré par IoT Platform.
PayloadBase64Byte	String	d29ybGQgaGVsbG8=	La charge utile de la réponse de l'appareil, encodée en Base64.
RequestId	String	41C4265E-F05D-4E2E-AB09-E031F501AF7F	L'ID de la requête.
RrpcCode	String	SUCCESS	Le code de réponse RRPC. Valeurs valides : UNKNOWN : exception système. SUCCESS : la requête a réussi. TIMEOUT : la requête a expiré. OFFLINE : l'appareil est hors ligne. HALFCONN : l'appareil est hors ligne mais n'a pas terminé un cycle complet de heartbeat.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs valides : true false

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=RRpc
&ProductKey=aldfeSe****
&DeviceName=device1
&RequestBase64Byte=dGhpcyBpcyBhbiBleGFtcGxl
&Timeout=1000
&<Common request parameters>

Exemple de réponse réussie

XML format

<?xml version='1.0' encoding='UTF-8'?>
  <RRpcResponse>
      <RequestId>41C4265E-F05D-4E2E-AB09-E031F501AF7F<RequestId/>
      <Success>true</Success>
      <RrpcCode>SUCCESS</RrpcCode>
      <PayloadBase64Byte>d29ybGQgaGVsbG8=</PayloadBase64Byte>
      <MessageId>889455942124347392</MessageId>
  </RRpcResponse>

JSON format

{
      "RrpcCode":"SUCCESS",
      "PayloadBase64Byte":"d29ybGQgaGVsbG8=",
      "MessageId":889455942124347392,
      "RequestId":"41C4265E-F05D-4E2E-AB09-E031F501AF7F",
      "Success":true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.