Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

Create Channel

Erstellen Sie einen neuen Kanal mit HTTP POST

Anfrage

HTTP-Methode

POST

URL

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

URL-Parameter

Name	Beschreibung
<format>	(Erforderlich) Format für die HTTP-Antwort, angegeben als json oder xml.

Beispiel: https://api.thingspeak.com/channels.json

Körperparameter

Name	Beschreibung	Werttyp
api_key	(Erforderlich) Geben Sie den Benutzer-API-Schlüssel an, den Sie in Ihrem profile finden. Dieser Schlüssel unterscheidet sich von den Kanal-API-Schlüsseln.	Zeichenfolge
description	(Optional) Geben Sie eine ID oder einen Namen für den Client an, der die Anfrage stellt.	Zeichenfolge
field1	(Optional) Feld 1 Name.	Zeichenfolge
fieldX	(Optional) Feld-X-Name, wobei X die Feld-ID ist.	Zeichenfolge
latitude	(Optional) Breitengrad in Grad.	Dezimal
longitude	(Optional) Längengrad in Grad.	Dezimal
metadata	(Optional) Metadaten für den Kanal, die JSON, XML oder andere Daten umfassen können.	Zeichenfolge
name	(Optional) Name des Kanals.	Zeichenfolge
public_flag	(Optional) Ob der Kanal öffentlich ist. Der Standardwert ist falsch.	true oder false
tags	(Optional) Durch Kommas getrennte Liste von Tags.	any
url	(Optional) Webseiten-URL für den Kanal.	Zeichenfolge

Inhaltstyp

application/x-www-form-urlencoded

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

 JSON-Beispiel

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

Antwort { "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 } ] }

 XML-Beispiel

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

Antwort <?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>

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

Verwenden Sie POSTMAN, um einen neuen öffentlichen Kanal zu erstellen

Sie können POSTMAN verwenden, um Ihre HTTP-Anfragen mithilfe der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie man mit POSTMAN einen neuen Kanal erstellt.

Erstellen Sie einen Kanal mit dem Titel „Mein Kanal“ mit drei benannten Feldern: „Sachen“, „Dinge“ und „Daten“. Machen Sie den Kanal für alle freigegeben, indem Sie public_flag auf true setzen. Hier ist das Format der Anfrage.

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

1. Wählen Sie in POSTMAN POST aus der Dropdown-Liste der HTTP-Verben aus und geben Sie https://api.thingspeak.com/channels.json in die Adressleiste ein.

2. Geben Sie den Parameter api_key und Ihren Benutzer-API-Schlüssel ein, der sich in Account > My Profile befindet.

3. Geben Sie die zusätzlichen Parameter und Werte ein:

   • public_flag, Value: true

   • field1, Value: Stuff

   • field2, Value: Things

   • field3, Value: Data

Die Antwort erfolgt im JSON-Format. Beachten Sie den Server-Antwortwert 200 OK, der die erfolgreiche Erstellung des Kanals anzeigt.

Der neue Kanal ist jetzt auf Ihrer channels -Seite verfügbar.

Siehe auch

Funktionen

• Clear Channel | Delete Channel

Themen

• Kanaleigenschaften