RRpc - IoT Platform - Centro de documentación de Alibaba Cloud

Envía una solicitud síncrona a un dispositivo específico y devuelve la respuesta.

Notas de uso

Si el dispositivo no responde dentro del periodo especificado en el parámetro Timeout, IoT Platform considera que la llamada falló, incluso si el dispositivo recibió el mensaje.

Límites de QPS

Puede llamar a esta operación hasta 1,000 veces por segundo por cuenta.

Nota

Los usuarios RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Puede llamar a esta operación en OpenAPI Explorer para generar código de ejemplo del SDK de forma automática.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	RRpc	La operación que desea ejecutar. Establezca el valor como RRpc.
ProductKey	String	Sí	aldfeSe****	El ProductKey del producto al que pertenece el dispositivo.
DeviceName	String	Sí	device1	El DeviceName del dispositivo de destino.
RequestBase64Byte	String	Sí	dGhpcyBpcyBhbiBleGFtcGxl	El cuerpo del mensaje por enviar. Convierta el mensaje original a datos binarios y codifíquelo en Base64. Nota IoT Platform decodifica los datos en Base64 antes de reenviarlos al dispositivo. El dispositivo recibe directamente el mensaje original.
Timeout	Integer	Sí	1000	El tiempo de espera de respuesta, en milisegundos. Valores válidos: de 1000 a 8000.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	El ID de la instancia. Consulte el ID en la página Overview de la consola de IoT Platform. Importante Si su instancia tiene un ID, debe especificarlo; de lo contrario, la llamada fallará. Si la página Overview no se muestra o su instancia no tiene ID, omita este parámetro. Descripción general.
Topic	String	No	/a1uZfYb**/A_Vol**/user/update	El tema RRPC personalizado. Configure el dispositivo antes de usar un tema personalizado. Uso de temas personalizados. Si no se especifica, se utiliza el tema RRPC predeterminado.
ContentType	String	No	240	El tipo de mensaje JT/T 808 enviado from el servidor al dispositivo. Valores válidos: 0: Datos del módulo GNSS. 11: Datos de tarjeta IC para permisos de transporte terrestre. 65: Datos de paso directo del puerto serial 1. 66: Datos de paso directo del puerto serial 2. 240 a 255: Datos de paso directo personalizados. Puertas de enlace JT/T 808.

Esta operación también requiere parámetros de solicitud comunes. Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	iot.system.SystemException	El código de error devuelto si la llamada falla. Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto si la llamada falla.
MessageId	Long	889455942124347392	El ID de mensaje generado por IoT Platform.
PayloadBase64Byte	String	d29ybGQgaGVsbG8=	La carga útil de respuesta del dispositivo codificada en Base64.
RequestId	String	41C4265E-F05D-4E2E-AB09-E031F501AF7F	El ID de la solicitud.
RrpcCode	String	SUCCESS	El código de respuesta RRPC. Valores válidos: UNKNOWN: Excepción del sistema. SUCCESS: La solicitud se completó correctamente. TIMEOUT: La solicitud excedió el tiempo de espera. OFFLINE: El dispositivo está desconectado. HALFCONN: El dispositivo está desconectado, pero no ha completado un ciclo completo de latido.
Success	Boolean	true	Indica si la llamada fue exitosa. Valores válidos: true false

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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
}

Códigos de error

Para consultar la lista de códigos de error, consulte Códigos de error del servicio.