Applicazione ThingTweet
Utilizza l'app ThingTweet per collegare un account Twitter® al tuo account ThingSpeak™ . Dispositivi e canali possono essere aggiornati tramite Twitter utilizzando l'API TweetControl. Ad esempio, puoi fare in modo che un dispositivo ti twitti quando la temperatura nella serra scende o quando le batterie di un dispositivo si stanno scaricando.
Associa il Twitter Account al ThingSpeak Account
Se hai effettuato l'accesso a un account Twitter , ThingTweet associa automaticamente l'account Twitter al tuo account utente ThingSpeak . Esci da Twitter per associare un account diverso.
Sign In a ThingSpeak.
Selezionare Apps > ThingTweet.
Fare clic su Link Twitter Account.
Verrai reindirizzato a Twitter. Quando ti viene chiesto di autorizzare ThingTweet a utilizzare il tuo account:
Inserisci il tuo nome utente e password Twitter .
Fare clic su Authorize app.
Dopo aver confermato l'account Twitter , fare clic sul collegamento Back to ThingTweet per tornare alla pagina dell'app ThingTweet.
Nota che il tuo account Twitter è ora collegato a ThingSpeak
L'app genera una chiave API ThingTweet che puoi utilizzare. Utilizza questa chiave API e un messaggio per inviare una richiesta a ThingTweet. Il messaggio viene inoltrato a Twitter. È possibile utilizzare tutti i parametri dell'API Twitter per inviare il messaggio. Per ulteriori informazioni, vedere statuses / update nella documentazione Twitter . Per visualizzare la chiave API ThingTweet per ciascuna app ThingTweet, selezionare Apps > ThingTweet.
Aggiorna lo stato Twitter
Per aggiornare il tuo stato Twitter con ThingTweet, invia un HTTP POST o GET con la chiave API ThingTweet e il tuo messaggio di stato.
Titolo | Richiesta HTTP di aggiornamento dello stato Twitter |
---|---|
URL | https://api.thingspeak.com/apps/thingtweet/1/statuses/update |
Metodo HTTP | PUBBLICA o OTTIENI |
Intestazione HTTP POST | X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX |
Parametri dati | api_key=XXXXXXXXXXXXXXXstatus=I just posted this from my Thing at %%datetime%% |
Risposta di successo | 1 |
Risposte agli errori | –1 |
Esempio di chiamata 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 |
Esempio di chiamata GET HTTP | https://api.thingspeak.com/apps/thingtweet/1/statuses/update?api_key=XXXXXXXXXXXXXXXX&status=HeyWorld |
"Appunti" | La chiave API ThingTweet deve apparire nell'intestazione HTTP o nella sezione del corpo del POST oppure può apparire in entrambi |
Esempio Richiesta POSTMAN
Puoi utilizzare POSTMAN per provare le tue richieste HTTP utilizzando l'API RESTful per ThingSpeak. Selezionare il Body della richiesta come x-www-form-urlencoded. Testa la richiesta tweet configurando POSTMAN come mostrato.
Aggiorna lo stato Twitter con l'ultimo valore dal canale
Puoi includere i dati del canale nel tuo messaggio Twitter . ThingTweet sostituisce "%%channel_CHANNEL-ID_field_FIELD-NUMBER%%"
con l'ultimo valore del canale e del campo specificati. Per aggiornare il tuo stato Twitter con l'ultimo valore del canale 1417, field1
, invia un POST HTTP.
Titolo | Richiesta HTTP POST per aggiornare lo stato Twitter con l'ultimo valore dal campo canale |
---|---|
URL | https://api.thingspeak.com/apps/thingtweet/1/statuses/update |
Metodo HTTP | POST |
Intestazione HTTP | X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX |
Parametri dati | api_key=XXXXXXXXXXXXXXXXstatus=The current CheerLights color is %%channel_1417_field_1%% at %%datetime%% |
Risposta di successo | 1 |
Risposte agli errori | –1 |
Esempio di chiamata 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 |
"Appunti" | La chiave API ThingTweet deve essere visualizzata nell'intestazione HTTP o nella sezione del corpo oppure può essere visualizzata in entrambe |
Esempio Richiesta POSTMAN
Puoi utilizzare POSTMAN per provare le tue richieste HTTP utilizzando l'API RESTful per ThingSpeak. Testare la richiesta tweet utilizzando POSTMAN e configurandola come mostrato.
Per aggiornare un canale e pubblicare contemporaneamente un tweet dal tuo dispositivo, vedi Write Data.
Chiavi sostitutive
Puoi trasmettere dati alle tue app utilizzando chiavi sostitutive. La tabella seguente riepiloga le chiavi sostitutive standard e personalizzate che è possibile utilizzare. Alcune chiavi sono specifiche per un particolare tipo di richiesta, come indicato nell'ultima colonna.
Chiave | Descrizione | Esempio | Usa con |
---|---|---|---|
%%YOUR_CUSTOM_LABEL%% | ThingHTTP sostituisce questo valore di sostituzione personalizzato con i dati nella richiesta di trigger che hanno l'etichetta "YOUR_CUSTOM_LABEL". | field1=%%YOUR_CUSTOM_LABEL%% Dati POST: YOUR_CUSTOM_LABEL=1234 .RISULTATO: field1=1234 . | Qualunque richiesta |
%%channel_CHANNEL_ID_field_FIELD_NUMBER%% | L'ultimo valore del canale e del campo specificati. Le richieste di sostituzione verso canali privati non di proprietà dello stesso utente della richiesta ThingHTTP restituiscono valori vuoti. | The latest value is %%channel_12_field_1%%.RISULTATO: The latest value is 2.5. | Qualunque richiesta |
%%datetime%% | La data e l'ora complete in cui è stato eseguito TimeControl o React. | The date and time the event occurred is %%datetime%%.RISULTATO: The date and time the event occurred is 24-09-2014 17:32. | TimeControl o React |
%%day%% | Il nome del giorno della settimana in cui è stato eseguito TimeControl. | The day the event occurred is %%giorno%%.RISULTATO: The day the event occurred is Mercoledì. | Timecontrol |
%%day_index%% | L'indice in base zero del giorno feriale che inizia la domenica. | The number of days used this week is %%day_index%%.RISULTATO: The number of days used this week is 3. | Timecontrol |
%%hour%% | L'ora del giorno in cui è stato eseguito TimeControl. | The hour that the event occurred is %%ora%%.RISULTATO: The hour that the event occurred is 5. | Timecontrol |
%%minute%% | Il minuto dell'ora in cui è stato eseguito TimeControl. | The minute the event occurred is %%minuto%%.RISULTATO: The minute the event occurred is 30. | Timecontrol |
%%trigger%% | Il valore che ha attivato React. | It is way too hot in here at %%trigger%% C .RISULTATO: It is way too hot in here at 40 C . | Reagire |
%%channel_id%% | L'ID del canale che ha attivato React. | The channel that tweets is %%channel_id%%.RISULTATO: The channel that tweets is 1256. | Reagire |