Cette page a été traduite par traduction automatique. Cliquez ici pour voir la version originale 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

développer tous les éléments de la page

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

Body

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 du canal.	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
`created_at`	(Facultatif) Date à laquelle l'entrée de flux a été créée, 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

Body

Exemple de texte

Exemple JSON

Exemple XML

Erreur

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

Exemples

développer tout

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

Dans POSTMAN, sélectionnez POST dans la liste déroulante des verbes HTTP et entrez https://api.thingspeak.com/update dans la barre d'adresse.
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