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 o 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. È anche possibile inviare la chiave API di scrittura utilizzando un'intestazione HTTP THINGSPEAKAPIKEY. La chiave API di scrittura si trova nella scheda API Keys della vista 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	intero
status	(Facoltativo) Messaggio di aggiornamento dello stato.	stringa
created_at	(Facoltativo) Data di creazione della 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 gli 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 di ingresso 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

Scrivere dati con GET

Puoi utilizzare il tuo browser web per completare le richieste HTTP GET all'API RESTful per ThingSpeak ™. Si noti che per i dispositivi o client incorporati che non codificano automaticamente le richieste GET tramite URL, è necessario codificare esplicitamente i parametri di query URL prima di effettuare la richiesta GET dal dispositivo.

Copia l'URL nella barra degli indirizzi del tuo browser web, sostituendo <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
}

Utilizzare POSTMAN per scrivere dati con POST

Puoi usare 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 indirizzo.

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

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

5. Entrano Parameter field1 e Value 123.

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

Scrivere voce codificata JSON

Puoi utilizzare il formato JSON per scrivere dati sul tuo canale. Questo esempio mostra una chiamata REST in formato JSON per scrivere più campi e informazioni di stato contemporaneamente. Anche la risposta è in formato 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