Main Content

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

Create Channel

Créer un nouveau canal avec HTTP POST

Requête

Méthode HTTP

POST

URL

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

Paramètres d'URL

NomDescription

<format>

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

Exemple : https://api.thingspeak.com/channels.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) Spécifiez un ID ou un nom pour le client effectuant la requête.

chaîne de caractère

field1

(Facultatif) Nom du champ 1.

chaîne de caractère

fieldX

(Facultatif) Nom du champ X, où X est l'ID du champ.

chaîne de caractère

latitude

(Facultatif) Latitude en degrés.

décimal

longitude

(Facultatif) Longitude en degrés.

décimal

metadata

(Facultatif) Métadonnées du canal, qui peuvent inclure JSON, XML ou toute autre donnée.

chaîne de caractère

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

développer tout

Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment créer un nouveau canal à l'aide de POSTMAN.

Créez un canal intitulé "Mon canal" avec trois champs nommés : Trucs », « Choses » et « Données ». Partagez le canal avec tout le monde en définissant le public_flag sur true. Voici le format de la requête.

POST https://api.thingspeak.com/channels.json
    api_key=XXXXXXXXXXXXXXXX
    name=My Channel
    public_flag=true
    field1=Stuff
    field=Things
    field3=Data

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

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

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

    • public_flag, Value : true

    • field1, Value : Stuff

    • field2, Value : Things

    • field3, Value : Data

La réponse est au format JSON. Notez la valeur de réponse du serveur de 200 OK, indiquant la création réussie du canal.

La nouvelle canal est maintenant disponible sur votre page channels.