Main Content

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

Write Data

Aggiorna i dati del canale con HTTP GET o POST

Richiesta

Metodo HTTP

POST oppure GET

URL

https://api.thingspeak.com/update.<format>

Parametri URL

NomeDescrizione

<format>

(Obbligatorio) Formato per la risposta HTTP, specificato come vuoto, json o xml.

Esempio:https://api.thingspeak.com/update.json

Corpo

NomeDescrizioneTipo di valore
api_key

(Obbligatorio) Scrivi la chiave API per questo canale specifico. Puoi anche inviare la chiave API di scrittura utilizzando un'intestazione HTTP THINGSPEAKAPIKEY. La chiave API di scrittura si trova nella scheda API Keys della visualizzazione canale.

stringa

field<X>

(Facoltativo) Dati del campo X, dove X è l'ID del campo

Qualunque
lat

(Facoltativo) Latitudine in gradi, specificata come valore compreso tra -90 e 90.

decimale

long

(Facoltativo) Longitudine in gradi, specificata come valore compreso tra -180 e 180.

decimale
elevation

(Facoltativo) Altitudine in metri

numero intero
status

(Facoltativo) Messaggio di aggiornamento dello stato.

stringa
twitter(Facoltativo) Twitter® nome utente collegato a ThingTweetstringa
tweet(Facoltativo) Aggiornamento dello stato Twitterstringa
created_at

(Facoltativo) Data in cui è stata creata la voce del feed, nel formato ISO 8601 , ad esempio: 2014-12-31 23:59:59. La data specificata deve essere univoca all'interno del canale. I fusi orari possono essere specificati utilizzando il parametro timezone.

datetime

Tipo di contenuto

Content-Type è richiesto solo per il metodo POST, non per il metodo GET.

application/x-www-form-urlencoded per la maggior parte degli aggiornamenti.

application/json per aggiornamenti in formato JSON.

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 Esempio di testo

 Esempio JSON

 Esempio XML

Errore

Per l'elenco completo, vedere Codici di errore.

Limitazioni

Tutti i timestamp devono essere univoci. Non è possibile scrivere nuovi dati utilizzando timestamp che corrispondono ai dati esistenti nel canale.

Esempi

espandi tutto

È possibile utilizzare il browser Web per completare le richieste GET HTTP all'API RESTful per ThingSpeak™. Tieni presente che per i dispositivi o i client incorporati che non codificano automaticamente l'URL delle richieste GET, devi esplicitamente parametri di query URL encode prima di effettuare la richiesta GET dal dispositivo.

Copia l'URL nella barra degli indirizzi del tuo browser web, cambiando <write_api_key> con la tua chiave API utente, che si trova in Account > My Profile.

https://api.thingspeak.com/update.json?api_key=<write_api_key>&field1=123

La risposta è un oggetto JSON della nuova voce e un 200 OK dal server.

{
    "channel_id": 266256,
    "created_at": "2018-09-10T17:41:59Z",
    "entry_id": 2,
    "field1": "123",
    "field2": null,
    "field3": null,
    "field4": null,
    "field5": null,
    "field6": null,
    "field7": null,
    "field8": null,
    "latitude": null,
    "longitude": null,
    "elevation": null,
    "status": null
}

Puoi utilizzare POSTMAN per provare le tue richieste HTTP utilizzando l'API RESTful per ThingSpeak. Questo esempio mostra come scrivere dati su un canale utilizzando POSTMAN.

Ecco il formato della richiesta HTTP.

POST https://api.thingspeak.com/update.json
       api_key=XXXXXXXXXXXXXXXX
       field1=123

  1. In POSTMAN, seleziona POST dall'elenco a discesa dei verbi HTTP.

  2. Inserisci https://api.thingspeak.com/update.json nel campo dell'indirizzo.

  3. Scegli x-www-form-urlencoded nella sezione Body .

  4. Inserisci Parameter api_key e la chiave API di scrittura, che si trova in Channels> API Keys.

  5. Inserisci il Parameter field1 e il Value 123.

La risposta è un oggetto JSON della nuova voce e un 200 OK dal server.

Puoi utilizzare il formato JSON per scrivere dati sul tuo canale. Questo esempio mostra una chiamata REST formattata JSON per scrivere più campi e informazioni sullo stato contemporaneamente. Anche la risposta è formattata JSON.

POST api.thingspeak.com/update.json
Content-Type: application/json
 
{ 
        "api_key": "XXXXXXXXXXXXXXXX"  
        "created_at": "2018-04-23 21:36:20 +0200", 
        "field1": "John Johnson", 
        "field3": 56, 
        "field4": 555, 
        "field5": 444, 
        "latitude": "", 
        "longitude": "", 
        "status": "Please check in!" 
    
}

La risposta è un oggetto JSON della nuova voce e un 200 OK dal server.

{
    "channel_id": 12345,
    "created_at": "2018-04-23 21:36:20 +0200", 
    "field1": "John Johnson", 
    "field3": 56, 
    "field4": 555, 
    "field5": 444, 
    "latitude": "", 
    "longitude": "", 
    "status": "Please check in!" 
}