Main Content

Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale in inglese.

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.

Argomenti complementari