Main Content

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

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

NomDescription

<channel_id>

(Obligatoire) ID du canal pour le canal d’intérêt.

<format>

(Obligatoire) Format de la réponse HTTP, spécifié comme json ou xml.

Exemple : https://api.thingspeak.com/channels/266256.json

Paramètres du corps de la requête

NomDescriptionType 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 -90 et 90.

décimal
longitude

(Facultatif) Longitude en degrés, spécifiée comme une valeur comprise entre -180 et 180.

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

Succès

Code HTTP status

200 OK

Corps

 Exemple JSON

 Exemple XML

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

  1. 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.

  2. Entrez le paramètre api_key dans la colonne valeur, entrez votre clé API utilisateur, qui se trouve dans Account > My Profile.

  3. 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.

Matériels supplémentaires