Controllo dati 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 ti consente di leggere da un canale privato e 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
Utilizza la chiave API Write per aggiornare un canale. Se la tua chiave API Write è compromessa, puoi generare una nuova chiave. Se utilizzi l'analisi MATLAB o la visualizzazione MATLAB , le informazioni sull'API vengono visualizzate nel riquadro della Guida a destra.
Per trovare la chiave API di scrittura:
Fare clic su Channels > My Channels.
Seleziona il canale da aggiornare.
Selezionare la scheda API Keys .
Leggi la chiave API
La chiave Read API consente alla tua applicazione di leggere i dati dall'API. Puoi generare più chiavi API di lettura per diverse applicazioni.
Per ottenere una chiave API di lettura:
Fare clic su Channels > My Channels.
Seleziona il canale da aggiornare.
Selezionare la scheda API Keys .
Fare clic su Generate New Read API Key.
Endpoint API
Indirizzo API HTTP
Per comunicazioni sicure verso ThingSpeak con HTTPS utilizzare l'indirizzo:
https://api.thingspeak.com
La comunicazione non protetta è supportata, ma è altamente 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 e un utente a pagamento può aggiornare ogni 1 secondo. L'aggiornamento più frequente genera un errore. Il tempo tra le richieste di lettura non è limitato da ThingSpeak per nessun utente. Vedere Frequently Asked Questions e How to Buy per le informazioni sulla licenza più aggiornate. Per modificare le impostazioni per soddisfare i requisiti dell'applicazione localmente, scarica il codice sorgente da GitHub .
Memorizzazione nella cache dell'API
Puoi memorizzare nella cache i dati quando li trasmetti 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 "risultati=100" o meno non vengono memorizzati nella cache, consentendo la produzione di applicazioni live.