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

Créer un graphique

Générer un diagramme avec HTTP GET

Requête

Méthode HTTP

GET

URL

https://api.thingspeak.com/channels/<channel_id>/charts/<field_id>

Paramètres d'URL

Nom	Description
`<channel_id>`	(Obligatoire) ID du canal pour le canal d’intérêt.
`<field_id>`	(Obligatoire) ID de champ pour le domaine d'intérêt.

Exemple : https://api.thingspeak.com/channels/99990/charts/2

Tracer les paramètres de la chaîne de requête

Utilisez ces paramètres pour ajuster les propriétés du diagramme . Utilisez ? pour ajouter le premier paramètre et & pour les paramètres suivants.

Nom	Description	Type de valeur
`title`	(Facultatif) Titre du graphique. La valeur par défaut est le nom du canal .	chaîne de caractère
`xaxis`	(Facultatif) Libellé de l'axe des abscisses du graphique. La valeur par défaut est "Date".	chaîne de caractère
`yaxis`	(Facultatif) Libellé de l'axe Y du graphique. La valeur par défaut est le nom du champ.	chaîne de caractère
`color`	(Facultatif) Valeur hexadécimale pour la couleur de ligne. La valeur par défaut est FF000 (rouge).	chaîne de caractère
`bgcolor`	(Facultatif) Couleur d'arrière-plan. La valeur par défaut est le blanc.	chaîne de caractère
`type`	(Facultatif) Type de diagramme. La valeur par défaut est la ligne.	`line`, `bar`, `column`, `spline`
`width`	(Facultatif) Largeur du graphique en pixels, la largeur de l'iframe est supérieure de 20 px, largeur du diagramme par défaut : 400. Réglez sur auto pour ajuster automatiquement la taille du diagramme en fonction de son conteneur parent.	entier
`height`	(Facultatif) Hauteur du graphique en pixels, la hauteur de l'iframe est supérieure de 20 px, hauteur du diagramme par défaut : 200. Réglez sur auto pour ajuster automatiquement la taille du diagramme en fonction de son conteneur parent.	entier
`dynamic`	(Facultatif) Effectuez automatiquement la mise à jour du diagramme en fonction de l'intervalle de temps mentionné dans la mise à jour. Le défaut est faux.	`true` ou `false`
`step`	(Facultatif) Dessinez un diagramme en tant que diagramme en étapes . Le défaut est faux.	`true` ou `false`
`yaxismin`	(Facultatif) Valeur minimale de l'axe Y du diagramme . Si vide, la valeur est calculée automatiquement.	décimal
`yaxismax`	(Facultatif) Valeur maximale de l'axe Y du diagramme . Si vide, la valeur est calculée automatiquement.	décimal
`update`	(Facultatif) Intervalle de temps en secondes pour mettre à jour automatiquement le diagramme . La valeur par défaut est 15.	entier

Envoyer en flux les paramètres de la chaîne de requête

Utilisez ces paramètres pour ajuster les propriétés des données de canal utilisées pour générer le diagramme. S'il n'y a pas de paramètres précédents, utilisez ? pour ajouter le premier paramètre, et & pour les paramètres suivants. Sinon, ajoutez tous les paramètres avec &.

Nom	Description	Type de valeur
`api_key`	(Obligatoire pour les canaux privés) Spécifiez la clé d'API en lecture pour ce canal spécifique. La clé d'API en lecture est disponible dans l'onglet Clés d'API de la vue des canaux.	chaîne de caractère
`results`	(Facultatif) Nombre d'entrées à récupérer. Le nombre maximum est de 8000. La valeur par défaut est 100.	entier
`days`	(Facultatif) Nombre de périodes de 24 heures avant maintenant à inclure dans le flux.	entier
`start`	(Facultatif) Date de début au format AAAA-MM-JJ%20HH:NN:SS.	date-heure
`end`	(Facultatif) Date de fin au format AAAA-MM-JJ%20HH:NN:SS.	date-heure
`offset`	(Facultatif) Décalage du fuseau horaire utilisé pour afficher les résultats. Utilisez le paramètre de fuseau horaire pour une plus grande précision.	entier
`min`	(Facultatif) Valeur minimale à inclure dans la réponse.	décimal
`max`	(Facultatif) Valeur maximale à inclure dans la réponse.	décimal
`round`	(Facultatif) Arrondissez à ce nombre de décimales.	entier
`timescale`	(Facultatif). Obtenez la première valeur dans ce nombre de minutes. Les valeurs valides sont : 10, 15, 20, 30, 60, 240, 720, 1440, "quotidien".	`integer or string`
`sum`	(Facultatif). Obtenez la somme de ce nombre de minutes. Les valeurs valides sont : 10, 15, 20, 30, 60, 240, 720, 1440, "quotidien".	`integer or string`
`average`	(Facultatif) Obtenez la moyenne de ce nombre de minutes. Les valeurs valides sont 10, 15, 20, 30, 60, 240, 720, 1440, "daily". Note: Les valeurs `NaN` sont interprétées comme `0` lors du calcul de la moyenne.	entier ou chaîne de caractère
`median`	(Facultatif) Obtenez la médiane de ce nombre de minutes. Les valeurs valides sont : 10, 15, 20, 30, 60, 240, 720, 1440, "quotidien"	`integer or string`

Réponse

Succès

Code HTTP Status

200 OK

Corps

La réponse est un diagramme ThingSpeak .

Erreur

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

Exemples

Vous pouvez utiliser votre navigateur Web pour effectuer des requêtes HTTP GET auprès de l'API RESTful ThingSpeak™. Pour voir le format d'une réponse HTTP, cliquez sur le lien ou copiez-le dans votre navigateur.

Modifier les paramètres d'affichage du graphique

Vous pouvez modifier les propriétés d'affichage du diagramme à l'aide des paramètres définis dans la requête sur l'API . Utilisez title pour ajouter un titre personnalisé, color pour modifier la couleur de la ligne et width pour spécifier une largeur personnalisée pour le tracé dans pixels. Créez un diagramme à l'aide de ce HTTP GET :

https://api.thingspeak.com/channels/276330/charts/7?title=Soil%20Moisture&color=FF69B4&width=850&xaxis=Time

La réponse est un chart qui affiche la mesure de l'humidité du sol avec une ligne rose, un titre personnalisé et une vue large. Les données proviennent d'une publication soil moisture monitor sur ThingSpeak Channel 276330.

Modifier les données du graphique

Vous pouvez modifier les données utilisées pour générer un diagramme personnalisé . Utilisez le paramètre average pour faire la moyenne sur un nombre défini de minutes, days pour sélectionner un nombre de jours de données, jusqu'à 8 000 points, et min pour afficher des données supérieures à une valeur minimale donnée. Créez un diagramme à l'aide de ce HTTP GET :

https://api.thingspeak.com/channels/276330/charts/1?average=240&days=7&min=200

La réponse est un chart qui affiche les valeurs moyennes d'humidité du sol sur une fenêtre de 240 minutes pendant quatre jours, à l'exclusion de tout point ayant une valeur inférieure à 200. Les données proviennent d'une publication soil moisture monitor sur ThingSpeak Channel 276330. L'exemple ici sera différent de ce que vous voyez puisque les données sont dynamiques.

Créer un graphique avec les paramètres de graphique et de flux

Vous pouvez utiliser à la fois les paramètres de diagramme et de flux pour créer un diagramme avec les propriétés souhaitées. Utilisez title, xaxis, color, type, width , height, average, yaxismax et $ pour créer un diagramme personnalisé. Créez un diagramme à l'aide de ce HTTP GET :

https://api.thingspeak.com/channels/38629/charts/2?title=Route%209%20Traffic&xaxis=Time&yaxis=Density%20of%20Eastbound%20Cars&color=0000FF&type=column&average=10&width=500&height=500&yaxismax=10&dynamic=true

La réponse est un chart qui affiche les valeurs moyennes de la température extérieure sur une fenêtre de 10 minutes en utilisant les données de température du champ 2 de ThingSpeak Channel 9.