Contrôle des données de canal
Clés API
Lorsque vous lisez ou écrivez des données sur votre canal à l'aide de l'API ThingSpeak™ ou du code MATLAB®, vous avez besoin des autorisations de lecture et d'écriture appropriées. La clé d'API à 16 chiffres vous permet de lire à partir d'un canal privé et d'écrire sur un canal. Vous n'avez pas besoin d'une clé d'API pour lire à partir d'un canal public ThingSpeak. Les clés API au niveau du compte sont décrites dans Comptes d'utilisateurs et canaux.
Écrire la clé API
Utilisez la clé d'API en écriture pour mettre à jour un canal. Si votre clé d'API en écriture est compromise, vous pouvez générer une nouvelle clé. Si vous utilisez l'analyse MATLAB ou la visualisation MATLAB, les informations sur l'API s'affichent dans le volet d'aide sur la droite.
Pour trouver votre clé d'API en écriture:
Cliquez sur Channels > My Channels.
Sélectionnez le canal à mettre à jour.
Sélectionnez onglet API Keys.
clé d'API en lecture
La clé d'API en lecture permet à votre application de lire les données de l'API. Vous pouvez générer plusieurs clés API de lecture pour différentes applications.
Pour obtenir une clé d'API en lecture :
Cliquez sur Channels > My Channels.
Sélectionnez le canal à mettre à jour.
Sélectionnez l'onglet API Keys.
Cliquez sur Generate New Read API Key.
Points de terminaison de l'API
Adresse API HTTP
Pour une communication sécurisée avec ThingSpeak avec HTTPS, utilisez l'adresse :
https://api.thingspeak.com
La communication non sécurisée est prise en charge, mais fortement déconseillée. Si nécessaire, pour la communication avec HTTP, utilisez l'adresse :
http://api.thingspeak.com
Adresse API MQTT
Pour communiquer avec le MQTT broker ThingSpeak au port 8883
(sécurisé) ou au port 1883
(non sécurisé), utilisez l'adresse :
mqtt3.thingspeak.com
Accès aux chaînes en MATLAB
Pour lire les données d'un canal privé dans MATLAB, utilisez la fonction thingSpeakRead
:
thingSpeakRead(channelID,'ReadKey','Your.Read.API.Key.String');
Pour écrire des données à partir de MATLAB, utilisez la fonction thingSpeakWrite
:
thingSpeakWrite(channelId,data,'WriteKey','Your.Write.API.Key.String');
Limites de débit API
Un utilisateur disposant d'une licence gratuite peut mettre à jour une canal ThingSpeak toutes les 15 secondes, et un utilisateur payant peut mettre à jour toutes les 1 seconde. Une mise à jour plus fréquente entraîne une erreur. Le temps entre les demandes de lecture n'est pas limité par ThingSpeak pour tous les utilisateurs. Voir Frequently Asked Questions et How to Buy pour les informations de licence les plus récentes. Pour modifier les paramètres afin de répondre aux exigences de votre application localement, téléchargez le code source à partir de GitHub .
Mise en cache de l'API
Vous pouvez mettre en cache les données lorsque vous les émettre via XML ou JSON. Les flux renvoyant plus de 100 entrées sont mis en cache pendant 5 minutes. Cette limite améliore les performances de l'application. Le dernier appel ou les flux spécifiant "results=100" ou moins ne sont pas mis en cache, permettant la production d'applications en live .