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

Write Data and Execute TalkBack Command

Mettez à jour les données du canal avec HTTP GET ou POST et exécutez la commande Talkback

Requête

Méthode HTTP

POST ou GET

URL

https://api.thingspeak.com/update.<format>

Paramètres d'URL

Nom	Description
<format>	Format de la réponse HTTP, spécifié comme json ou xml.

Exemple : https://api.thingspeak.com/update.json?api_key=XXXXXXXXXXXXXXXXtalkback_key=YYYYYYYYYYYYYYYY

Corps

Nom	Description	Type de valeur
api_key	(Obligatoire) Spécifiez la clé d'API en écriture pour ce canal spécifique. Vous pouvez également envoyer la clé d'API en écriture à l'aide d'un en-tête HTTP THINGSPEAKAPIKEY. La clé API d'écriture se trouve dans l'onglet API Keys de la vue des canaux.	chaîne de caractère
talkback_key	(Obligatoire) clé d'API pour une instance spécifique de Talkback. L'inclusion de la clé d'API Talkback entraîne la suppression de la commande suivante dans la file d'attente et renvoie la commande dans la réponse.	chaîne de caractère
field<X>	(Facultatif) Données du champ X, où X est l'ID du champ	n'importe quel
lat	(Facultatif) Latitude en degrés	décimal
long	(Facultatif) Longitude en degrés	décimal
elevation	(Facultatif) Altitude en mètres	entier
status	(Facultatif) Message de mise à jour du statut	chaîne de caractère
twitter	(Facultatif) Twitter® nom d'utilisateur lié à ThingTweet	chaîne de caractère
tweet	(Facultatif) Mise à jour du statut Twitter	chaîne de caractère
created_at	(Facultatif) Date de création de l'entrée de flux, au format ISO 8601, par exemple, 2014-12-31 23:59:59. Doit être unique dans le canal. Les fuseaux horaires peuvent être spécifiés à l'aide du paramètre timezone.	date-heure

Type de contenu

Content-Type est requis uniquement pour la méthode POST, pas pour la méthode GET.

Utilisez application/json pour les mises à jour au format JSON.

Utilisez application/x-www-form-urlencoded pour toutes les autres mises à jour.

Réponse

Succès

Code HTTP Status

200 OK

Corps

 Exemple de texte

POST https://api.thingspeak.com/update api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

Réponse La réponse est la chaîne de caractère de commande de la prochaine commande Talkback dans la file d' Talkback TalkBack avec la clé d'API Talkback spécifiée. Si la mise à jour échoue, la réponse est 0.

 Exemple JSON

POST https://api.thingspeak.com/update.json api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

La réponse est un objet JSON de la commande suivante dans la file d'attente Talkback avec la clé d'API Talkback spécifiée, par exemple : { "id": 15254213, "command_string": "OPENDOOR", "position": null, "executed_at": "2019-03-05T15:48:29Z", "created_at": "2019-02-26T13:45:09Z" }

 Exemple XML

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

La réponse est un objet XML de la commande suivante dans la file d'attente Talkback avec la clé d'API Talkback spécifiée, par exemple : <command> <id type="integer">15338752</id> <command-string>OPENDOOR</command-string> <position type="integer" nil="true"/> <executed-at type="dateTime">2019-03-05T15:52:08Z</executed-at> <created-at type="dateTime">2019-03-05T15:51:54Z</created-at> </command>

Erreur

Pour la liste complète, voir Codes d'erreur.

Exemples

Utiliser POSTMAN pour ajouter une commande Talkback

Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment mettre à jour simultanément un canal et exécuter une commande Talkback à partir d'une file d'attente existante à l'aide de POSTMAN.

Écrivez 123 dans le champ 1 d'un canal et renvoyez la commande Talkback suivante dans une file d'attente Talkback existante.

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     talkback_key=YYYYYYYYYYYYYYYYY

1. Dans POSTMAN, sélectionnez POST dans la liste déroulante des verbes HTTP et saisissez https://api.thingspeak.com/update dans la barre d'adresse.

2. Saisissez les paramètres et valeurs supplémentaires :

   • Key : api_key, Value : XXXXXXXXXXXXXXXX

   • Key : talkback_key, Value : YYYYYYYYYYYYYYYY

La réponse est au format texte. Notez la valeur de réponse du serveur de 200 OK, qui indique la réussite de la mise à jour du canal et de l'exécution de la commande Talkback .

La commande exécutée est indiquée dans la réponse.

Limites

Tous les horodatages doivent être uniques. Vous ne pouvez pas écrire de nouvelles données en utilisant des horodatages qui correspondent aux données existantes dans le canal.

Voir aussi

Bulk Write Data | Add Command | Get All Commands | Update Command | Execute Command | Delete Command