Kanaldatenkontrolle
API-Schlüssel
Wenn Sie mithilfe der ThingSpeak™- API oder des MATLAB®- Codes Daten in Ihren Kanal lesen oder schreiben, benötigen Sie die entsprechenden Lese- und Schreibberechtigungen. Mit dem 16-stelligen API-Schlüssel können Sie von einem privaten Kanal lesen und in einen Kanal schreiben. Sie benötigen keinen API-Schlüssel, um aus einem öffentlichen ThingSpeak- Kanal zu lesen. API-Schlüssel auf Kontoebene werden in Benutzerkonten und Kanäle beschrieben.
API-Schlüssel schreiben
Verwenden Sie den Write-API-Schlüssel, um einen Kanal zu aktualisieren. Wenn Ihr Write-API-Schlüssel gefährdet ist, können Sie einen neuen Schlüssel generieren. Wenn Sie MATLAB Analysis oder MATLAB Visualization verwenden, werden die API-Informationen im Hilfebereich auf der rechten Seite angezeigt.
So finden Sie Ihren Write-API-Schlüssel:
Klicken Sie auf Channels > My Channels.
Wählen Sie den zu aktualisierenden Kanal aus.
Wählen Sie die Registerkarte API Keys .
API-Schlüssel lesen
Der Read API-Schlüssel ermöglicht Ihrer Anwendung, Daten von der API zu lesen. Sie können mehrere Read-API-Schlüssel für verschiedene Anwendungen generieren.
So erhalten Sie einen Lese-API-Schlüssel:
Klicken Sie auf Channels > My Channels.
Wählen Sie den zu aktualisierenden Kanal aus.
Wählen Sie die Registerkarte API Keys .
Klicken Sie auf Generate New Read API Key.
API-Endpunkte
HTTP-API-Adresse
Für eine sichere Kommunikation zu ThingSpeak mit HTTPS verwenden Sie die Adresse:
https://api.thingspeak.com
Unsichere Kommunikation wird unterstützt, es wird jedoch dringend davon abgeraten. Verwenden Sie bei Bedarf für die Kommunikation mit HTTP die Adresse:
http://api.thingspeak.com
MQTT-API-Adresse
Um mit dem ThingSpeak MQTT-Broker am Port 8883 (sicher) oder Port 1883 (nicht sicher) zu kommunizieren, verwenden Sie die Adresse:
mqtt3.thingspeak.com
Kanalzugriff in MATLAB
Um Daten von einem privaten Kanal in MATLAB einzulesen, verwenden Sie die Funktion thingSpeakRead :
thingSpeakRead(channelID,'ReadKey','Your.Read.API.Key.String');
Um Daten aus MATLAB zu schreiben, verwenden Sie die Funktion thingSpeakWrite :
thingSpeakWrite(channelId,data,'WriteKey','Your.Write.API.Key.String');
API-Ratenbegrenzungen
Ein Benutzer mit einer kostenlosen Lizenz kann alle 15 Sekunden einen ThingSpeak- Kanal aktualisieren, und ein kostenpflichtiger Benutzer kann alle 1 Sekunde aktualisieren. Eine häufigere Aktualisierung führt zu einem Fehler. Die Zeit zwischen Leseanforderungen ist für keinen Benutzer durch ThingSpeak begrenzt. Die aktuellsten Lizenzinformationen finden Sie Frequently Asked Questions und How to Buy . Um die Einstellungen lokal an Ihre Anwendungsanforderungen anzupassen, laden Sie den Quellcode von GitHub herunter.
API-Caching
Sie können Daten zwischenspeichern, wenn Sie sie per XML oder JSON übertragen. Feeds, die mehr als 100 Einträge zurückgeben, werden 5 Minuten lang zwischengespeichert. Dieses Limit verbessert die Anwendungsleistung. Der letzte Aufruf oder Feeds mit der Angabe „Ergebnisse=100“ oder weniger werden nicht zwischengespeichert, sodass Live-Anwendungen erstellt werden können.
