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

API REST

Utilizzare le chiamate API REST per creare e aggiornare i canali e i grafici ThingSpeak™

Il trasferimento di stato rappresentativo (REST) è uno stile architettonico progettato come modello richiesta-risposta che comunica tramite HTTP. ThingSpeak, una piattaforma IoT, utilizza le chiamate API REST GET, POST, PUT e DELETE per creare ed eliminare canali, leggere e scrivere dati di canale e cancellare i dati in un canale. Un browser web o un client invia una richiesta al server, che risponde con i dati nel formato richiesto. I browser Web utilizzano questa interfaccia per recuperare pagine Web o per inviare dati a server remoti.

È anche possibile utilizzare le chiamate API REST con Agire sui dati, che consentono di interagire con social media, servizi web e dispositivi.

Riferimento API REST

espandi tutto

Leggi i dati

`Read Data`	Leggi i dati da tutti i campi nel canale con HTTP GET
`Read Field`	Leggi i dati da un singolo campo del canale con HTTP GET
`Read Status`	Leggi il campo di stato del canale con HTTP GET
`Read Last Entry`	Leggi l'ultima voce nel canale con HTTP GET
`Read Last Field Entry`	Leggi l'ultima voce nel campo del canale con HTTP GET
`Read Last Status`	Leggi l'ultimo stato del canale con HTTP GET

Scrivi dati

`Write Data`	Aggiorna i dati del canale con HTTP GET o POST
`Bulk Write JSON Data`	Scrivere molte voci sul canale in formato JSON con un singolo HTTP POST
`Bulk Write CSV Data`	Scrivere molte voci sul canale in formato CSV con un singolo HTTP POST

Scrivi immagini

`Write Image`	Scrivi l'immagine del canale con HTTP POST
`Delete Image`	Elimina l'immagine dal canale con HTTP DELETE
`Read Status of Image Request`	Leggi lo stato della richiesta di immagine con HTTP GET

Visualizza canali e impostazioni canale

`List Your Public Channels`	Elenca i canali per nome utente con HTTP GET
`List Your Channels`	Elenca i tuoi canali con HTTP GET
`List Channels`	Elenca i canali pubblici con HTTP GET
`Read Settings`	Leggi le impostazioni del canale con HTTP GET
`Write Settings`	Aggiornare le impostazioni del canale con HTTP PUT

Crea ed elimina

`Create Channel`	Crea un nuovo canale con HTTP POST
`Clear Channel`	Cancella tutti i dati dal canale con HTTP DELETE
`Delete Channel`	Elimina il canale con HTTP DELETE

Leggi l'età di ingresso

`Read Last Entry Age`	Leggi il numero di secondi dall'ultima voce nel canale con HTTP GET
`Read Last Field Entry Age`	Leggi il numero di secondi dall'ultima voce nel campo con HTTP GET

Grafici

Create Chart Genera grafico con HTTP GET

Mappe

Show Channel Map Mostra la posizione del canale sulla mappa

TalkBack

`Add Command`	Aggiungi il comando TalkBack alla coda TalkBack
`Get Command`	Ottieni il comando TalkBack dalla coda TalkBack
`Get All Commands`	Ottieni tutti i comandi TalkBack dalla coda TalkBack
`Get Last Command`	Recupera l’ultimo comando TalkBack eseguito dalla coda di TalkBack
`Update Command`	Aggiorna il comando nella coda di TalkBack
`Execute Command`	Esegui il prossimo comando TalkBack nella coda TalkBack
`Write Data and Execute TalkBack Command`	Aggiorna i dati del canale con HTTP GET o POST ed esegui il comando TalkBack
`Delete Command`	Elimina il comando TalkBack dalla coda TalkBack
`Delete All Commands`	Elimina tutti i comandi TalkBack nella coda TalkBack

Avvisi

`Send Alert`	Crea un avviso e-mail con HTTP POST
`Get Alert History`	Ottieni la cronologia degli avvisi con HTTP GET

Argomenti

Scegli tra REST API e MQTT API
Scopri quando utilizzare REST e MQTT per aggiornare un canale.
Aggiornamento in blocco tramite Arduino o ESP8266
Questo esempio mostra come utilizzare una scheda Arduino® MKR1000 o una scheda ESP8266 connessa a una rete Wi-Fi® per raccogliere continuamente la potenza del segnale Wi-Fi e aggiornare in blocco un canale ThingSpeak ™.
Aggiornamento in blocco di un canale ThingSpeak utilizzando una scheda fotonica di particelle
Questo esempio mostra come utilizzare una scheda Particle Photon connessa a una rete Wi-Fi® per aggiornare in blocco un canale ThingSpeak ™.
Aggiornamento in blocco tramite una scheda Raspberry Pi
Questo esempio mostra come raccogliere dati utilizzando una scheda Raspberry Pi connessa tramite Wi-Fi che esegue Python 2.7.
Riferimento ai fusi orari
Aggiungi il parametro del fuso orario alla tua richiesta HTTP.

Risoluzione dei problemi

Codici di errore

Visualizza i dettagli dei messaggi di errore dell'API REST ThingSpeak e i corrispondenti codici di stato HTTP.

Informazioni complementari

Esempi in primo piano

Prototipazione con sensore di prossimità sonar

Questo esempio mostra come realizzare un prototipo con ThingSpeak ™ utilizzando una scheda Arduino® connessa tramite Wi-Fi.

Apri live script

Dati di temperatura post e lettura dal canale

Questo esempio mostra come raccogliere dati ambientali da un dispositivo e post dal dispositivo su un canale ThingSpeak ™. L'esempio utilizza un ESP8266 e la libreria di comunicazione ThingSpeak per post dati e recuperarli da un canale.

Apri live script

Intensità del segnale di rete wireless con ESP32 con Arduino IDE

Questo esempio mostra come utilizzare la funzionalità di rete wireless di ESP32 per post dati a ThingSpeak ™. L'ESP32 registra e pubblica la potenza del segnale della rete wireless a cui è connesso. Premi un pulsante sulla scheda per effettuare tre misurazioni della potenza del segnale della rete wireless e post il risultato medio a un canale ThingSpeak. Il dispositivo pubblica anche un valore contatore, così puoi tenere traccia delle misurazioni.

Apri live script

Scrivere l'immagine su ThingSpeak da Raspberry Pi con Python

Scrivere un'immagine su un canale immagine ThingSpeak da una scheda Raspberry Pi^® utilizzando Python^®.

Apri live script

Scrivere l'immagine su ThingSpeak dalla scheda della fotocamera ESP32

Acquisire un'immagine da una scheda fotocamera ESP32 e scrivila su un canale immagine ThingSpeak.

Apri live script