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

Nome	Descrizione
<format>	(Obbligatorio) Formato per la risposta HTTP, specificato come vuoto, json o xml.

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

Corpo

Nome	Descrizione	Tipo 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 ThingTweet	stringa
tweet	(Facoltativo) Aggiornamento dello stato Twitter	stringa
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

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

Risposta La risposta è l'ID della voce dell'aggiornamento, ad esempio: 18. Se l'aggiornamento fallisce, la risposta è 0.

 Esempio JSON

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

La risposta è un oggetto JSON della nuova voce, ad esempio: { "channel_id": 3, "field1": '73', "field2": null, "field3": null, "field4": null, "field5": null, "field6": null, "field7": null, "field8": null, "created_at": '2014-02-25T14:13:01-05:00', "entry_id": 320, "status": null, "latitude": null, "longitude": null, "elevation": null }

 Esempio XML

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73

La risposta è un oggetto XML della nuova voce, ad esempio: <?xml version="1.0" encoding="UTF-8"?> <feed> <channel-id type="integer">3</channel-id> <field1>73</field1> <field2 nil="true"/> <field3 nil="true"/> <field4 nil="true"/> <field5 nil="true"/> <field6 nil="true"/> <field7 nil="true"/> <field8 nil="true"/> <created-at type="dateTime">2014-02-25T14:15:42-05:00</created-at> <entry-id type="integer">321</entry-id> <status nil="true"/> <latitude type="decimal" nil="true"/> <longitude type="decimal" nil="true"/> <elevation nil="true"/> </feed>

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

Scrivi dati con GET

È 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
}

Utilizza POSTMAN per scrivere dati con POST

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.

Scrivi la voce codificata JSON

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!" 
}

Vedi anche

Read Data | Read Field | Read Status | Bulk Write Data

Argomenti

• Proprietà del canale