Write Settings
Mettre à jour les paramètres du canal avec HTTP PUT
Requête
Description
Utilisez cette requête pour écrire les paramètres du canal . Les paramètres de canal incluent la description du canal , les noms de champ, l'emplacement du canal , les métadonnées, le statut public ou privé et le nom du canal.
Méthode HTTP
PUT
URL
https://api.thingspeak.com/channels/
<channel_id>
.<format>
Paramètres d'URL
Nom | Description |
---|---|
| (Obligatoire) ID du canal pour le canal d’intérêt. |
| (Obligatoire) Format de la réponse HTTP, spécifié comme |
Exemple : https://api.thingspeak.com/channels/266256.json
Paramètres du corps de la requête
Nom | Description | Type de valeur |
---|---|---|
api_key | (Obligatoire) Spécifiez la clé API utilisateur, que vous pouvez trouver dans votre profile. Cette clé est différente des clés d'API de canal . | chaîne de caractère |
description | (Facultatif) Description du canal. | chaîne de caractère |
field1 | (Facultatif) Nom du champ 1. | chaîne de caractère> |
field<X> | (Facultatif) Nom du champ X, où X est l'ID du champ. | chaîne de caractère |
latitude | (Facultatif) Latitude en degrés, spécifiée comme une valeur comprise entre | décimal |
longitude | (Facultatif) Longitude en degrés, spécifiée comme une valeur comprise entre | décimal |
elevation | (Facultatif) Altitude en mètres. | entier |
metadata | (Facultatif) Métadonnées du canal, qui peuvent inclure JSON, XML ou toute autre donnée. | texte |
name | (Facultatif) Nom du canal. | chaîne de caractère |
public_flag | (Facultatif) Indique si le canal est public. Le défaut est faux. | true ou false |
tags | (Facultatif) Liste de balises séparées par des virgules. | chaîne de caractère |
url | (Facultatif) URL de la page Web du canal. | chaîne de caractère |
Type de contenu
application/x-www-form-urlencoded
Réponse
Erreur
Pour la liste complète, voir Codes d'erreur.
Exemples
Utiliser POSTMAN pour écrire les paramètres du canal
Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment écrire de nouveaux paramètres de canal à l'aide de POSTMAN.
À l'aide d'un canal existant, modifiez le nom du canal en Updated Channel
et le titre du champ 1 en Heart Rate
. Changez également le partage en Public.
PUT https://api.thingspeak.com/channels/CHANNEL_ID api_key=XXXXXXXXXXXXXXXX name=Updated Channel public_flag=true field1=Heart Rate
Dans POSTMAN, sélectionnez PUT dans la liste déroulante des verbes HTTP et entrez
api.thingspeak.com/channels/<CHANNEL_ID>.json
dans la barre d'adresse, en remplaçant<CHANNEL_ID>
par le canal d’intérêt.Entrez le paramètre
api_key
dans la colonne valeur, entrez votre clé API utilisateur, qui se trouve dans Account > My Profile.Entrez des paramètres et des valeurs supplémentaires :
name
, Value :Updated Channel
field1
, Value :Heart Rate
public_flag
, Value :True
La réponse est au format JSON. Notez la valeur de réponse du serveur de 200 OK, indiquant la réussite de l'écriture des nouveaux paramètres de canal .
Les nouveaux paramètres de canal sont désormais disponibles sur votre page channels.