Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch 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 Kanalbeschreibung, Feldnamen, Kanalstandort, Metadaten, öffentlicher oder privater 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 profile 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) Feld-X-Name, 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 umfassen können.	Text
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.	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 der 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 der 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 mithilfe der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie Sie mit POSTMAN neue Kanaleinstellungen schreiben.

Ändern Sie unter Verwendung eines vorhandenen Kanals den Kanalnamen in Updated Channel und den Titel von Feld 1 in Heart Rate. Ändern Sie außerdem die Freigabe in „Ö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. Ersetzen Sie <CHANNEL_ID> durch den gewünschten Kanal.

2. Geben Sie den Parameter api_key in die Wertspalte 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 erfolgt im JSON-Format. Beachten Sie den Server-Antwortwert 200 OK, der das erfolgreiche Schreiben neuer Kanaleinstellungen anzeigt.

Die neuen Kanaleinstellungen sind jetzt auf Ihrer channels- Seite verfügbar.

Zusätzliches Material

Siehe auch

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

Themen

• Kanaleigenschaften