このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。
ThingTweet アプリ
ThingTweetアプリを使用して、 Twitter®アカウントを ThingSpeak™アカウントにリンクします。デバイスとチャネルは、 TweetControl API を使用してTwitter経由で更新できます。たとえば、温室の温度が下がったときやデバイスのバッテリーが少なくなっているときに、デバイスにツイートさせることができます。
TwitterアカウントをThingSpeakアカウントに関連付ける
Twitterアカウントにログインしている場合、 ThingTweet は、使用可能なTwitterアカウントを ThingSpeakユーザー アカウントに自動的に関連付けます。Twitterからログアウトして、別のアカウントを関連付けます。
Sign InからThingSpeakまで。
Apps 、 ThingTweetを選択します。
[Link Twitter Account]をクリックします。
Twitterにリダイレクトされます。ThingTweet によるアカウントの使用を許可するように求められたら、次を行います。
Twitterのユーザー名とパスワードを入力します。
[Authorize app]をクリックします。
Twitterアカウントを確認したら、リンクBack to ThingTweetをクリックしてThingTweetアプリのページに戻ります。
TwitterアカウントがThingSpeakにリンクされたことに注目してください
アプリにより ThingTweet API キーが生成されます。この API キーとメッセージを使用して、要求を ThingTweet に送信します。メッセージはTwitterに中継されます。Twitter API のすべてのパラメーターを使用してメッセージを送信できます。詳細については、statuses / update Twitterを参照してください。各ThingTweetアプリのThingTweet API キーを表示するには、 Apps 、 ThingTweetを選択します。
Twitterステータスを更新
ThingTweetでTwitterステータスを更新するには、 ThingTweet API キーとステータス メッセージを使用して HTTP POST またはGET を送信します。
タイトル | Twitterステータスを更新するための HTTP要求 |
---|---|
《URL》 | https://api.thingspeak.com/apps/thingtweet/1/statuses/update |
《HTTPメソッド》 | POST またはGET |
«POST HTTPヘッダー» | X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX |
«データパラメーター» | api_key=XXXXXXXXXXXXXXXstatus=I just posted this from my Thing at %%datetime%% |
≪成功時の応答≫ | 1 |
「エラー応答」 | –1 |
«POST HTTP 呼び出しのサンプル» | POST /apps/thingtweet/1/statuses/update HTTP/1.1 Host: api.thingspeak.com Content-Type: application/x-www-form-urlencoded Cache-Control: no-cacheapi_key=YOUR_THINGTWEET_API_KEYstatus=I+just+posted+this+from+my+Thing+at+%25%25datetime%25%25 |
« GET HTTP 呼び出しのサンプル» | https://api.thingspeak.com/apps/thingtweet/1/statuses/update?api_key=XXXXXXXXXXXXXXXX&status=HeyWorld |
"ノート" | ThingTweet API キーは、HTTP ヘッダーまたは POST のbodyセクションのいずれかに指定する必要があります。あるいは、両方に指定することもできます。 |
POSTMAN 要求の例
POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。要求のBody をx-www-form-urlencodedとして選択します。次のように POSTMAN を構成して、ツイートの要求をテストします。
チャネルからの最後の値でTwitterステータスを更新します
Twitterメッセージにチャネルデータを含めることができます。ThingTweet は、 "%%channel_CHANNEL-ID_field_FIELD-NUMBER%%"
を指定されたチャネルとフィールドの最後の値に置き換えます。Twitterステータスをチャネル1417 の最後の値field1
で更新するには、HTTP POST を送信します。
タイトル | チャネルフィールドの最後の値でTwitterステータスを更新する HTTP POST要求 |
---|---|
《URL》 | https://api.thingspeak.com/apps/thingtweet/1/statuses/update |
《HTTPメソッド》 | POST |
«HTTPヘッダー» | X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX |
«データパラメーター» | api_key=XXXXXXXXXXXXXXXXstatus=The current CheerLights color is %%channel_1417_field_1%% at %%datetime%% |
≪成功時の応答≫ | 1 |
「エラー応答」 | –1 |
«HTTP 呼び出しのサンプル» | POST /apps/thingtweet/1/statuses/updateHTTP/1.1 Host: api.thingspeak.com Content-Type: application/x-www-form-urlencoded Cache-Control: no-cacheapi_key=YOUR_THINGTWEET_API_KEYstatus=The+current+CheerLights+color+is+%25%25channel_1417_field_1%25%25+at+%25%25datetime%25%25 |
"ノート" | ThingTweet API キーは、HTTP の header セクションと body セクションのどちらかになければなりませんが、両方に追加することはできます。 |
POSTMAN 要求の例
POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。POSTMAN を使用し、次のように構成して、ツイートの要求をテストします。
チャネルを更新し、同時にデバイスからツイートを投稿するには、 「 Write Data 」を参照してください。
置き換えキー
置換キーを使用してデータをアプリに渡すことができます。次の表は、使用可能な標準とカスタムの置き換えキーをまとめています。一部のキーは特定タイプの要求に固有のものであり、最後の列に示されています。
キー | 説明 | 例 | 使用対象 |
---|---|---|---|
%%YOUR_CUSTOM_LABEL%% | ThingHTTP はこのカスタムの置き換え値を、"YOUR_CUSTOM_LABEL" のラベルをもつトリガー要求のデータに置き換えます。 | field1=%%YOUR_CUSTOM_LABEL%% POST データ:YOUR_CUSTOM_LABEL=1234 .結果:field1=1234 。 | 任意の要求 |
%%channel_CHANNEL_ID_field_FIELD_NUMBER%% | 指定されたチャネルおよびフィールドの最後の値。ThingHTTP 要求と同じユーザーが所有していないプライベート チャネルへの置き換え要求には、空白の値が返されます。 | The latest value is «%%channel_12_field_1%%».結果:The latest value is «2.5»。 | 任意の要求 |
%%datetime%% | TimeControl または React が実行されたときの完全な日付と時刻。 | The date and time the event occurred is «%%datetime%%».結果:The date and time the event occurred is «2014-09-24 5:32 pm»。 | TimeControl または React |
%%day%% | TimeControl が実行されたときの曜日の名前。 | The day the event occurred is «%%day%%».結果:The day the event occurred is «水曜日»。 | TimeControl |
%%day_index%% | 日曜日から始まる 0 ベースの曜日インデックス。 | The number of days used this week is «%%day_index%%».結果:The number of days used this week is «3»。 | TimeControl |
%%hour%% | TimeControl が実行された時数。 | The hour that the event occurred is «%%hour%%».結果:The hour that the event occurred is «5»。 | TimeControl |
%%minute%% | TimeControl が実行された分数。 | The minute the event occurred is «%%分%%»。結果:The minute the event occurred is «30»。 | TimeControl |
%%trigger%% | React をトリガーした値。 | It is way too hot in here at «%%トリガー%%» C .RESULT:It is way too hot in here at «40» C 。 | React |
%%channel_id%% | React をトリガーしたチャネルの ID。 | The channel that tweets is «%%channel_id%%».結果:The channel that tweets is «1256»。 | React |