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

Write Settings

Aktualisieren Sie die Kanaleinstellungen mit HTTP PUT

Anfrage

Beschreibung

Verwenden Sie diese Anfrage, um Kanaleinstellungen zu schreiben. Zu den Kanaleinstellungen gehören die Kanalbeschreibung, Feldnamen, der Kanalstandort, Metadaten, der öffentliche oder private Status und der Name des Kanals.

HTTP-Methode

PUT

URL

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

URL-Parameter

Name	Beschreibung
<channel_id>	(Erforderlich) Kanal-ID für den gewünschten Kanal.
<format>	(Erforderlich) Format für die HTTP-Antwort, angegeben als json oder xml.

Beispiel: https://api.thingspeak.com/channels/266256.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) Beschreibung des Kanals.	Zeichenfolge
field1	(Optional) Name von Feld 1.	Zeichenfolge>
field<X>	(Optional) Name des Felds X, wobei X die Feld-ID ist.	Zeichenfolge
latitude	(Optional) Breitengrad in Grad, angegeben als Wert zwischen -90 und 90.	dezimal
longitude	(Optional) Längengrad in Grad, angegeben als Wert zwischen -180 und 180.	dezimal
elevation	(Optional) Höhe in Metern.	ganze Zahl
metadata	(Optional) Metadaten für den Kanal, die JSON, XML oder andere Daten enthalten können.	Text
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.	Zeichenfolge
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

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

Die Antwort ist ein JSON-Objekt mit den aktualisierten Kanalinformationen, zum Beispiel: { "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 } ] }

 XML-Beispiel

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

Die Antwort ist ein XML-Objekt mit den aktualisierten Kanalinformationen, zum Beispiel: <?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>

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

Verwenden Sie POSTMAN, um Kanaleinstellungen zu schreiben

Sie können POSTMAN verwenden, um Ihre HTTP-Anfragen mit der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie neue Kanaleinstellungen mit POSTMAN geschrieben werden.

Ändern Sie bei Verwendung eines vorhandenen Kanals den Kanalnamen in Updated Channel und den Titel von Feld 1 in Heart Rate. Ändern Sie außerdem die Freigabe auf „Öffentlich“.

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

1. Wählen Sie in POSTMAN PUT aus der Dropdown-Liste der HTTP-Verben aus und geben Sie api.thingspeak.com/channels/<CHANNEL_ID>.json in die Adressleiste ein, wobei Sie <CHANNEL_ID> durch den gewünschten Kanal ersetzen.

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

3. Geben Sie zusätzliche Parameter und Werte ein:

   • name, Value: Updated Channel

   • field1, Value: Heart Rate

   • public_flag, Value: True

Die Antwort liegt im JSON-Format vor. Beachten Sie den Serverantwortwert von 200 OK, der das erfolgreiche Schreiben der neuen Kanaleinstellungen anzeigt.

Die neuen Kanaleinstellungen sind jetzt auf Ihrer Kanäle-Seite verfügbar.

Zusätzliches Material

Siehe auch

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

Themen

• Kanaleigenschaften