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

Write Settings

Aggiorna le impostazioni del canale con HTTP PUT

Richiesta

Descrizione

Utilizza questa richiesta per scrivere le impostazioni del canale. Le impostazioni del canale includono la descrizione del canale, i nomi dei campi, la posizione del canale, i metadati, lo stato pubblico o privato e il nome del canale.

Metodo HTTP

PUT

URL

https://api.thingspeak.com/channels/<channel_id>.<format>

Parametri URL

Nome	Descrizione
<channel_id>	(Obbligatorio) ID canale per il canale di interesse.
<format>	(Obbligatorio) Formato per la risposta HTTP, specificato come json o xml.

Esempio: https://api.thingspeak.com/channels/266256.json

Parametri del corpo

Nome	Descrizione	Tipo di valore
api_key	(Obbligatorio) Specifica la chiave API utente, che puoi trovare nel tuo profile. Questa chiave è diversa dalle chiavi API del canale.	stringa
description	(Facoltativo) Descrizione del canale.	stringa
field1	(Facoltativo) Nome del campo 1.	stringa>
field<X>	(Facoltativo) Nome del campo X, dove X è l'ID del campo.	stringa
latitude	(Facoltativo) Latitudine in gradi, specificata come valore compreso tra -90 e 90.	decimale
longitude	(Facoltativo) Longitudine in gradi, specificata come valore compreso tra -180 e 180.	decimale
elevation	(Facoltativo) Altitudine in metri.	numero intero
metadata	(Facoltativo) Metadati per il canale, che possono includere JSON, XML o qualsiasi altro dato.	testo
name	(Facoltativo) Nome del canale.	stringa
public_flag	(Facoltativo) Indica se il canale è pubblico. L'impostazione predefinita è falsa.	true oppure false
tags	(Facoltativo) Elenco di tag separati da virgole.	stringa
url	(Facoltativo) URL della pagina web per il canale.	stringa

Tipo di contenuto

application/x-www-form-urlencoded

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 Esempio JSON

PUT https://api.thingspeak.com/channels/4.json api_key=XXXXXXXXXXXXXXXX name=Updated Channel

La risposta è un oggetto JSON delle informazioni sul canale aggiornate, ad esempio: { "id": 4, "name": "Updated Channel", "description": null, "metadata": null, "latitude": null, "longitude": null, "created_at": "2014-03-25T13:12:50-04:00", "elevation": null, "last_entry_id": null, "ranking": 15, "username": "iothans", "tags": [], "api_keys": [ { "api_key": "XXXXXXXXXXXXXXXX", "write_flag": true } ] }

 Esempio XML

PUT https://api.thingspeak.com/channels/4.xml api_key=XXXXXXXXXXXXXXXX name=Updated Channel

La risposta è un oggetto XML delle informazioni aggiornate sul canale, ad esempio: <?xml version="1.0" encoding="UTF-8"?> <channel> <id type="integer">4</id> <name>Updated Channel</name> <description nil="true" /> <metadata nil="true" /> <latitude type="decimal" nil="true" /> <longitude type="decimal" nil="true" /> <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at> <elevation nil="true" /> <last-entry-id type="integer" nil="true" /> <ranking type="integer">15</ranking> <username>iothans</username> <tags type="array" /> <api-keys type="array"> <api-key> <api-key>XXXXXXXXXXXXXXXX</api-key> <write-flag type="boolean">true</write-flag> </api-key> </api-keys> </channel>

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

Usa POSTMAN per scrivere le impostazioni del canale

Puoi utilizzare POSTMAN per provare le tue richieste HTTP utilizzando l'API RESTful per ThingSpeak. Questo esempio mostra come scrivere nuove impostazioni del canale utilizzando POSTMAN.

Utilizzando un canale esistente, modifica il nome del canale in Updated Channel e il titolo del campo 1 in Heart Rate. Cambia anche la condivisione in Pubblica.

PUT https://api.thingspeak.com/channels/CHANNEL_ID
    api_key=XXXXXXXXXXXXXXXX
    name=Updated Channel
    public_flag=true
    field1=Heart Rate

1. In POSTMAN, seleziona PUT dall'elenco a discesa dei verbi HTTP e inserisci api.thingspeak.com/channels/<CHANNEL_ID>.json nella barra degli indirizzi, sostituendo <CHANNEL_ID> con il canale di interesse.

2. Inserisci il parametro api_key nella colonna del valore, inserisci la chiave API utente, che si trova in Account > My Profile.

3. Inserisci parametri e valori aggiuntivi:

   • name, Value: Updated Channel

   • field1, Value: Heart Rate

   • public_flag, Value: True

La risposta è in formato JSON. Notare il valore di risposta del server pari a 200 OK, che indica la scrittura riuscita delle nuove impostazioni del canale.

Le nuove impostazioni del canale sono ora disponibili sulla tua pagina channels .

Materiale aggiuntivo

Vedi anche

List Your Public Channels | List Your channels | List Channels | Read Settings

Argomenti

• Proprietà del canale