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

Create Channel

Crea un nuovo canale con HTTP POST

Richiesta

Metodo HTTP

POST

URL

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

Parametri URL

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

Esempio: https://api.thingspeak.com/channels.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) Specificare un ID o un nome per il client che effettua la richiesta.	stringa
field1	(Facoltativo) Nome del campo 1.	stringa
fieldX	(Facoltativo) Nome del campo X, dove X è l'ID del campo.	stringa
latitude	(Facoltativo) Latitudine in gradi.	decimale
longitude	(Facoltativo) Longitudine in gradi.	decimale
metadata	(Facoltativo) Metadati per il canale, che possono includere JSON, XML o qualsiasi altro dato.	stringa
name	(Facoltativo) Nome del canale.	stringa
public_flag	(Facoltativo) Indica se il canale è pubblico. L'impostazione predefinita è false.	true oppure false
tags	(Facoltativo) Elenco di tag separati da virgole.	any
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

POST https://api.thingspeak.com/channels.json api_key=XXXXXXXXXXXXXXXX name=My New Channel

Risposta { "id": 4, "name": "My New 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

POST https://api.thingspeak.com/channels.xml api_key=XXXXXXXXXXXXXXXX name=My New Channel

Risposta <?xml version="1.0" encoding="UTF-8"?> <channel> <id type="integer">399673</id> <name>MyChannel</name> <description nil="true"/> <latitude type="decimal">0.0</latitude> <longitude type="decimal">0.0</longitude> <created-at type="dateTime">2018-01-08T22:40:44Z</created-at> <elevation nil="true"/> <last-entry-id type="integer" nil="true"/> <public-flag type="boolean">true</public-flag> <url nil="true"/> <ranking type="integer">30</ranking> <metadata nil="true"/> <license-id type="integer">40512190</license-id> <tags type="array"/> <api-keys type="array"> <api-key> <api-key>XXXXXXXXXXXXXXXX</api-key> <write-flag type="boolean">true</write-flag> </api-key> <api-key> <api-key>XXXXXXXXXXXXXXXX</api-key> <write-flag type="boolean">false</write-flag> </api-key> </api-keys> </channel>

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

Utilizza POSTMAN per creare un nuovo canale pubblico

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

Crea un canale intitolato "Il mio canale" con tre campi denominati: "Roba", "Cose" e "Dati". Rendi il canale condiviso con tutti impostando public_flag su true. Ecco il formato della richiesta.

POST https://api.thingspeak.com/channels.json
    api_key=XXXXXXXXXXXXXXXX
    name=My Channel
    public_flag=true
    field1=Stuff
    field=Things
    field3=Data

1. In POSTMAN, seleziona POST dall'elenco a discesa dei verbi HTTP e inserisci https://api.thingspeak.com/channels.json nella barra degli indirizzi.

2. Inserisci il parametro api_key e la chiave API utente, che si trova in Account > My Profile.

3. Inserisci i parametri e i valori aggiuntivi:

   • public_flag, Value: true

   • field1, Value: Stuff

   • field2, Value: Things

   • field3, Value: Data

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

Il nuovo canale è ora disponibile sulla tua pagina channels .

Vedi anche

Funzioni

• Clear Channel | Delete Channel

Argomenti

• Proprietà del canale