Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um das englische Original zu sehen.

Create Channel

Neuen Kanal mit HTTP POST erstellen

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 Profil 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) Name von Feld 1.	Zeichenfolge
fieldX	(Optional) Name des Felds X, 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 enthalten können.	Zeichenfolge
name	(Optional) Name des Kanals.	Zeichenfolge
public_flag	(Optional) Ob der Kanal öffentlich ist. Der Standardwert ist „false“.	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 mit der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie Sie mit POSTMAN einen neuen Kanal erstellen.

Erstellen Sie einen Kanal mit dem Titel „Mein Kanal“ mit drei benannten Feldern: „Zeug“, „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 User-API-Schlüssel ein, der sich unter 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 liegt im JSON-Format vor. Beachten Sie den Serverantwortwert von 200 OK, der die erfolgreiche Erstellung des Kanals anzeigt.

Der neue Kanal ist jetzt auf Ihrer Kanäle-Seite verfügbar.

Siehe auch

Funktionen

• Clear Channel | Delete Channel

Themen

• Kanaleigenschaften