Controllo dei dati del canale
Chiavi API
Quando leggi o scrivi dati sul tuo canale utilizzando l'API ThingSpeak™ o il codice MATLAB®, hai bisogno delle autorizzazioni di lettura e scrittura appropriate. La chiave API a 16 cifre consente di leggere da un canale privato e di scrivere su un canale. Non è necessaria una chiave API per leggere da un canale pubblico ThingSpeak. Le chiavi API a livello di account sono descritte in Account utente e canali.
Scrivi la chiave API
Utilizzare la chiave API di scrittura per aggiornare un canale. Se la tua chiave API di scrittura è compromessa, puoi generare una nuova chiave. Se si utilizza MATLAB Analysis o MATLAB Visualization, le informazioni API vengono visualizzate nel riquadro della Guida a destra.
Per trovare la tua chiave API di scrittura:
Clicca Channels > My Channels.
Seleziona il canale da aggiornare.
Selezionare la scheda API Keys.
Leggi la chiave API
La chiave API di lettura consente all'applicazione di leggere i dati dall'API. È possibile generare più chiavi API di lettura per diverse applicazioni.
Per ottenere una chiave API di lettura:
Clicca Channels > My Channels.
Seleziona il canale da aggiornare.
Selezionare la scheda API Keys.
Clicca Generate New Read API Key.
Endpoint API
Indirizzo API HTTP
Per comunicazioni sicure con ThingSpeak tramite HTTPS utilizzare l'indirizzo:
https://api.thingspeak.com
La comunicazione non sicura è supportata, ma fortemente sconsigliata. Se necessario, per la comunicazione con HTTP utilizzare l'indirizzo:
http://api.thingspeak.com
Indirizzo API MQTT
Per comunicare con il broker MQTT ThingSpeak sulla porta 8883 (sicura) o sulla porta 1883 (non sicura), utilizzare l'indirizzo:
mqtt3.thingspeak.com
Accesso al canale in MATLAB
Per leggere i dati da un canale privato in MATLAB, utilizzare la funzione thingSpeakRead:
thingSpeakRead(channelID,'ReadKey','Your.Read.API.Key.String');
Per scrivere dati da MATLAB, utilizzare la funzione thingSpeakWrite:
thingSpeakWrite(channelId,data,'WriteKey','Your.Write.API.Key.String');
Limiti di velocità API
Un utente con una licenza gratuita può aggiornare un canale ThingSpeak ogni 15 secondi, mentre un utente a pagamento può aggiornarlo ogni 1 secondo. Aggiornamenti più frequenti generano un errore. Il tempo tra le richieste di lettura non è limitato da ThingSpeak per nessun utente. Per le informazioni più aggiornate sulla licenza, consulta le Domande frequenti e Come acquistare. Per modificare le impostazioni in modo da soddisfare i requisiti della tua applicazione a livello locale, scarica il codice sorgente da GitHub .
Memorizzazione nella cache dell'API
È possibile memorizzare nella cache i dati quando li si trasmette tramite XML o JSON. I feed che restituiscono più di 100 voci vengono memorizzati nella cache per 5 minuti. Questo limite migliora le prestazioni dell'applicazione. L'ultima chiamata o i feed che specificano "results=100" o meno non vengono memorizzati nella cache, consentendo la produzione di applicazioni live.
