本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>API>MQTT>PublishMQTTMessage

PublishMQTTMessage

処理概要

指定したMQTTサーバーにメッセージを送信(Publish)します。
メッセージは管理者ユーザーの権限で送信されます。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
MQTTInstanceIdentifier メッセージを送信するMQTTサーバーのサーバー名を指定します。
英数字、"_"、"-"、"."が使用可能です。
文字列 32  
Password メッセージを送信する管理者ユーザーのパスワードを指定します。
英数字、"_"、"-"、"."が使用可能です。
文字列 32  
Topic メッセージを送信するトピックを指定します。 文字列 64    
Message メッセージの内容を指定します。 文字列 1024  
Qos メッセージの到達保証レベルを指定します。
0: QoS0 1:QoS1 2:QoS2
  数値   0  
Retain 最新のメッセージをトピックに保持するかどうかを指定します。
0:保持しない 1:保持する
  数値   0  

レスポンス

要素名 説明 備考
MQTTInstanceIdentifier MQTTサーバー名 文字列  
Topic メッセージ送信先のトピック 文字列  
Message メッセージ内容 文字列  
Qos メッセージの到達保証レベル 数値  
Retain メッセージ保持の有無 数値  

サンプル

リクエストサンプル
curl https://mqtt.api.cloud.nifty.com/mqtt ¥
  -H "x-amz-date:20151103T150000Z" ¥
  -H "authorization: AWS4-HMAC-SHA256 Credential=<YOU APP KEY>/20151103/jp-east-1/mqtt/aws4_request, SignedHeaders=host;x-amz-date, Signature=XXX..." ¥
  -H "x_amz_target:2016-01-25N2016-01-25.PublishMQTTMessage" ¥
  -H "accept-encoding':gzip, deflate" ¥
  -H "user-agent:<YOUR USER AGENT>" ¥
  -H "content-type:application/x-www-form-urlencoded" ¥
  -H "accept:application/xhtml+xml" ¥
  -H "host: mqtt.api.cloud.nifty.com:443" ¥
  -d "MQTTInstanceIdentifier=samplemqtt" ¥
  -d "Password=password" ¥
  -d "Topic=news" ¥
  -d "Message=samplemessage"
レスポンスサンプル
<?xml version="1.0"?>
<PublishMQTTMessageResponse
  xmlns="http://mqtt.api.cloud.nifty.com/doc/2015-03-19/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-message"
  xsi:type="PublishMQTTMessageResponse">
  <PublishMQTTMessageResult>
    <MQTTMessage>
      <MQTTInstanceIdentifier>mymqtt</MQTTInstanceIdentifier>
      <Topic>/myroom/messages</Topic>
      <Message>message</Message>
      <QoS>0</QoS>
      <Retain>0</Retain>
    </MQTTMessage>
  </PublishMQTTMessageResult>
</PublishMQTTMessageResponse>

推奨画面サイズ 1024×768 以上