阅读982 返回首页    go 魔兽

发布消息到Topic__接口列表_服务器端API_阿里云物联网套件-阿里云

发消息到指定的Topic

描述

请求参数

名称 类型 是否必须 描述
<公共参数> 见 公共参数
ProductKey String 是 以哪个ProductKey来进行发送
MessageContent String 是 发送的消息，将消息内容二进制进行BASE64转码后得到的字符串
TopicFullName String 是 消息发送目的Topic名字,如 /ProductKey/topic1/xxx
Qos Integer 否 指定消息发送的方式;
0:最多发送一次, 1: 最少发送一次
需要注意的是: 消息在IOT套件中最多保存7天

返回参数

名称 类型 描述
RequestId String 表示调用返回码(UNKNOW,SUCCESS,TIMEOUT)
Success Boolean 表示调用成功与否
ErrorMessage String 出错信息

示例

  • 请求示例
  1.  https://iot.aliyuncs.com/?&Action=Pub
  2.          &ProductKey=...
  3.          &TopicFullName=%252F1231231%252Ftopic1%252F1
  4.          &MessageContent=aGVsbG93b3JsZA
  5.          &<[公共请求参数]>

  • SDK示例代码 [SDK下载]

    • java
      1. PubRequest pub = new PubRequest();
      2. pub.setProductKey(ProductKey);
      3. pub.setMessageContent("aGVsbG93b3JsZA==");// Hello world base64 String.
      4. pub.setTopicFullName("/.../home/admin/adfadsfa/dsafsfa");//消息发送给哪个topic中.
      5. pub.setQos(1);//设置Qos为1，那么设备如果不在线，重新上线会收到离线消息，消息最多在Iot Hub中保存7天.
      6. PubResponse response = client.getAcsResponse(pub);
      7. System.out.println(response.getRequestId());//当次请求的ID
      8. System.out.println(response.getSuccess());//请求是否成功.
      9. System.out.println(response.getErrorMessage());//出错时的错误信息

    • php

      1. $request = new IotPubRequest();
      2. $request->setProductKey($productKey);
      3. $request->setQos(0);
      4. $request->setMessageContent("aGVsbG93b3JsZA==");// Hello world base64 String.
      5. $request->setTopicFullName("/60027911/home/admin/adfadsfa/dsafsfa");//消息发送给哪个topic中.
      6. $response = $client->getAcsResponse($request);
      7. print_r("rn");
      8. print_r($response);

    • python

      1. request = PubRequest.PubRequest()
      2. request.set_accept_format('json')    // 设置返回数据格式，默认为XML
      3. request.set_ProductKey('...')
      4. request.set_TopicFullName('/.../test')    // 消息发送给哪个topic中
      5. request.set_MessageContent('aGVsbG93b3JsZA==')    // Hello world base64 String
      6. result = clt.do_action(request)
      7. print 'publish : ' + result

  • 返回示例

    json示例

  1. {
  2.     "RequestId":"BB71E443-4447-4024-A000-EDE09922891E",
  3.     "Success":true,
  4. }

XML示例

  1. <PubResponse>
  2.     <RequestId>BB71E443-4447-4024-A000-EDE09922891E</RequestId>
  3.     <Success>true</Success>
  4. </PubResponse>

最后更新：2016-12-06 17:27:06

  上一篇：go 批量获取设备状态__接口列表_服务器端API_阿里云物联网套件-阿里云
  下一篇：go 发送消息给设备并得到设备响应__接口列表_服务器端API_阿里云物联网套件-阿里云