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 |
---|---|
| (Erforderlich) Kanal-ID für den gewünschten Kanal. |
| (Erforderlich) Format für die HTTP-Antwort, angegeben als |
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 | Dezimal |
longitude | (Optional) Längengrad in Grad, angegeben als Wert zwischen | 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
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
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.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.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.