Application ThingTweet

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

Utilisez l'application ThingTweet pour lier un compte Twitter^® à votre compte ThingSpeak™. Les appareils et les canaux peuvent être mis à jour via Twitter à l'aide de l'API TweetControl. Par exemple, vous pouvez faire en sorte qu'un appareil vous tweete lorsque la température dans votre serre baisse ou lorsque les piles d'un appareil sont faibles.

Associer le compte Twitter au compte ThingSpeak

Si vous êtes connecté à un compte Twitter, ThingTweet associe automatiquement le compte Twitter disponible à votre compte utilisateur ThingSpeak. Déconnectez-vous de Twitter pour associer un autre compte.

Sign In à ThingSpeak.
Sélectionnez Apps > ThingTweet.
Cliquez sur Link Twitter Account.
Vous êtes redirigé vers Twitter. Lorsqu'on vous demande d'autoriser ThingTweet à utiliser votre compte :
- Entrez votre nom d'utilisateur et votre mot de passe Twitter.
- Cliquez sur Authorize app.
Après avoir confirmé le compte Twitter, cliquez sur le lien Back to ThingTweet pour revenir à la page de l'application ThingTweet.
Notez que votre compte Twitter est désormais lié à ThingSpeak .

L'application génère une clé API ThingTweet que vous pouvez utiliser. Utilisez cette clé d'API et un message pour envoyer une requête à ThingTweet. Le message est relayé à Twitter. Vous pouvez utiliser tous les paramètres de l'API Twitter pour envoyer le message. Voir statuses / update dans la documentation Twitter pour plus d'informations. Pour afficher la clé d'API ThingTweet pour chaque application ThingTweet, sélectionnez Apps > ThingTweet.

Mettre à jour le statut Twitter

Pour mettre à jour votre statut Twitter avec ThingTweet, envoyez un HTTP POST ou GET avec la clé d'API ThingTweet et votre message de statut.

Titre	Requête HTTP pour mettre à jour le statut Twitter
URL	`https://api.thingspeak.com/apps/thingtweet/1/statuses/update`
Méthode HTTP	POST ou GET
En-tête HTTP POST	X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX
Paramètres de données	`api_key=XXXXXXXXXXXXXXXstatus=I just posted this from my Thing at %%datetime%%`
Réponse de réussite	1
Réponses aux erreurs	-1
Exemple d'appel HTTP POST	`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`
Exemple d'appel HTTP GET	`https://api.thingspeak.com/apps/thingtweet/1/statuses/update?api_key=XXXXXXXXXXXXXXXX&status=HeyWorld`
"Remarques"	La clé d'API ThingTweet doit apparaître dans l'en-tête HTTP ou dans la section du corps de texte du POST, ou elle peut apparaître dans les deux

Exemple de requête POSTMAN

Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Sélectionnez le Body de la demande comme x-www-form-urlencoded. Testez la requête de tweet en configurant POSTMAN comme indiqué.

Mettre à jour le statut Twitter avec la dernière valeur du canal

Vous pouvez inclure des données de canal dans votre message Twitter. ThingTweet remplace "%%channel_CHANNEL-ID_field_FIELD-NUMBER%%" par la dernière valeur du canal et du champ spécifiés. Pour mettre à jour votre statut Twitter avec la dernière valeur du canal 1417, field1, envoyez un HTTP POST.

Titre	Demande HTTP POST de mise à jour du statut Twitter avec la dernière valeur du champ de canal
URL	`https://api.thingspeak.com/apps/thingtweet/1/statuses/update`
Méthode HTTP	POST
En-tête HTTP	`X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX`
Paramètres de données	`api_key=XXXXXXXXXXXXXXXXstatus=The current CheerLights color is %%channel_1417_field_1%% at %%datetime%%`
Réponse de succès	1
Réponses aux erreurs	-1
Exemple d'appel 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`
"Remarques"	La clé d'API ThingTweet doit apparaître dans l'en-tête HTTP ou dans la section du corps de texte, ou elle peut apparaître dans les deux

Exemple de requête POSTMAN

Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Testez la requête de tweet à l'aide de POSTMAN et configurez comme indiqué.

Pour mettre à jour une canal et publier simultanément un tweet depuis votre appareil, consultez Write Data.

Clés de rechange

Vous pouvez transmettre des données à vos applications à l'aide de clés de remplacement. Le tableau suivant récapitule les clés de remplacement standard et personnalisées que vous pouvez utiliser. Certaines clés sont spécifiques à un type particulier de requête, comme indiqué dans la dernière colonne.

Clé	Description	Exemple	Utiliser avec
`%%YOUR_CUSTOM_LABEL%%`	ThingHTTP remplace cette valeur de remplacement personnalisée par des données dans la requête déclencheur portant le libellé "YOUR_CUSTOM_LABEL".	`field1=%%YOUR_CUSTOM_LABEL%%`Données POST : `YOUR_CUSTOM_LABEL=1234`.RESULTAT : `field1=1234`.	N'importe quelle requête
`%%channel_CHANNEL_ID_field_FIELD_NUMBER%%`	La dernière valeur du canal et du champ spécifiés. Les requêtes de remplacement vers des canaux privés n'appartenant pas au même utilisateur que la requête ThingHTTP renvoient des valeurs vides.	`The latest value is` %%channel_12_field_1%%.RESULTAT : `The latest value is` 2.5.	N'importe quelle requête
`%%datetime%%`	La date et l'heure complètes d'exécution de TimeControl ou React.	`The date and time the event occurred is` %%datetime%%.RESULTAT : `The date and time the event occurred is` 24/09/2014 17h32.	TimeControl ou React
`%%day%%`	Le nom du jour de la semaine où TimeControl a été exécuté.	`The day the event occurred is` %%jour%%.RESULTAT : `The day the event occurred is` Mercredi.	TimeControl
`%%day_index%%`	L'indice de base zéro du jour de la semaine commençant le dimanche.	`The number of days used this week is` %%day_index%%.RESULTAT : `The number of days used this week is` 3.	TimeControl
`%%hour%%`	L'heure de la journée à laquelle TimeControl s'est exécuté.	`The hour that the event occurred is` %%heure%%.RESULTAT : `The hour that the event occurred is` 5.	TimeControl
`%%minute%%`	La minute de l'heure d'exécution du TimeControl .	`The minute the event occurred is` %%minute%%.RESULTAT : `The minute the event occurred is` 30.	TimeControl
`%%trigger%%`	La valeur qui a déclenché React.	`It is way too hot in here at` %%trigger%% `C`.RESULTAT : `It is way too hot in here at` 40 `C`.	React
`%%channel_id%%`	L'ID du canal qui a déclenché React.	`The channel that tweets is` %%channel_id%%.RESULTAT : `The channel that tweets is` 1256.	React