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

Write Data

Aktualisieren Sie die Kanaldaten mit HTTP GET oder POST

Anfrage

HTTP-Methode

POST oder GET

URL

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

URL-Parameter

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

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

Körper

Name	Beschreibung	Werttyp
api_key	(Erforderlich) Schreiben Sie einen API-Schlüssel für diesen spezifischen Kanal. Sie können den Schreib-API-Schlüssel auch mithilfe eines THINGSPEAKAPIKEY-HTTP-Headers senden. Der Schreib-API-Schlüssel befindet sich auf der Registerkarte API Keys der Kanalansicht.	Zeichenfolge
field<X>	(Optional) Feld-X-Daten, wobei X die Feld-ID ist	beliebig
lat	(Optional) Breitengrad in Grad, angegeben als Wert zwischen -90 und 90.	Dezimal
long	(Optional) Längengrad in Grad, angegeben als Wert zwischen -180 und 180.	Dezimal
elevation	(Optional) Höhe in Metern	ganze Zahl
status	(Optional) Statusaktualisierungsnachricht.	Zeichenfolge
twitter	(Optional) Twitter® Benutzername, der mit ThingTweet verknüpft ist	Zeichenfolge
tweet	(Optional) Twitter Statusaktualisierung	Zeichenfolge
created_at	(Optional) Datum, an dem der Feedeintrag erstellt wurde, im Format ISO 8601 , zum Beispiel: 2014-12-31 23:59:59. Das von Ihnen angegebene Datum muss innerhalb des Kanals eindeutig sein. Zeitzonen können mit dem Parameter timezone angegeben werden.	Terminzeit

Inhaltstyp

Content-Type ist nur für die POST-Methode erforderlich, nicht für die GET-Methode.

application/x-www-form-urlencoded für die meisten Updates.

application/json für Updates im JSON-Format.

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

 Textbeispiel

POST https://api.thingspeak.com/update api_key=XXXXXXXXXXXXXXXX field1=73

Antwort Die Antwort ist die Eintrags-ID des Updates, zum Beispiel: 18. Wenn das Update fehlschlägt, ist die Antwort 0.

 JSON-Beispiel

POST https://api.thingspeak.com/update.json api_key=XXXXXXXXXXXXXXXX field1=73

Die Antwort ist ein JSON-Objekt des neuen Eintrags, zum Beispiel: { "channel_id": 3, "field1": '73', "field2": null, "field3": null, "field4": null, "field5": null, "field6": null, "field7": null, "field8": null, "created_at": '2014-02-25T14:13:01-05:00', "entry_id": 320, "status": null, "latitude": null, "longitude": null, "elevation": null }

 XML-Beispiel

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73

Die Antwort ist ein XML-Objekt des neuen Eintrags, zum Beispiel: <?xml version="1.0" encoding="UTF-8"?> <feed> <channel-id type="integer">3</channel-id> <field1>73</field1> <field2 nil="true"/> <field3 nil="true"/> <field4 nil="true"/> <field5 nil="true"/> <field6 nil="true"/> <field7 nil="true"/> <field8 nil="true"/> <created-at type="dateTime">2014-02-25T14:15:42-05:00</created-at> <entry-id type="integer">321</entry-id> <status nil="true"/> <latitude type="decimal" nil="true"/> <longitude type="decimal" nil="true"/> <elevation nil="true"/> </feed>

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Einschränkungen

Alle Zeitstempel müssen eindeutig sein. Sie können keine neuen Daten mit Zeitstempeln schreiben, die mit vorhandenen Daten im Kanal übereinstimmen.

Beispiele

Daten mit GET schreiben

Sie können Ihren Webbrowser verwenden, um GET-HTTP-Anfragen an die RESTful-API für ThingSpeak™ auszuführen. Beachten Sie, dass Sie bei eingebetteten Geräten oder Clients, die GET-Anfragen nicht automatisch per URL kodieren, Parameter explizit URL encode müssen, bevor Sie die GET-Anfrage vom Gerät stellen.

Kopieren Sie die URL in die Adressleiste Ihres Webbrowsers und ändern Sie <write_api_key> in Ihren Benutzer-API-Schlüssel, der sich in Account > My Profile befindet $.

https://api.thingspeak.com/update.json?api_key=<write_api_key>&field1=123

Die Antwort ist ein JSON-Objekt des neuen Eintrags und ein 200 OK vom Server.

{
    "channel_id": 266256,
    "created_at": "2018-09-10T17:41:59Z",
    "entry_id": 2,
    "field1": "123",
    "field2": null,
    "field3": null,
    "field4": null,
    "field5": null,
    "field6": null,
    "field7": null,
    "field8": null,
    "latitude": null,
    "longitude": null,
    "elevation": null,
    "status": null
}

Verwenden Sie POSTMAN, um Daten mit POST zu schreiben

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

Hier ist das Format der HTTP-Anfrage.

POST https://api.thingspeak.com/update.json
       api_key=XXXXXXXXXXXXXXXX
       field1=123

1. Wählen Sie in POSTMAN POST aus der Dropdown-Liste der HTTP-Verben aus.

2. Geben Sie https://api.thingspeak.com/update.json in das Adressfeld ein.

3. Wählen Sie x-www-form-urlencoded im Abschnitt Body .

4. Geben Sie Parameter api_key und Ihren Schreib-API-Schlüssel ein, der sich in Channels> API Keys befindet.

5. Geben Sie Parameter field1 und Value 123 ein.

Die Antwort ist ein JSON-Objekt des neuen Eintrags und ein 200 OK vom Server.

Schreiben Sie einen JSON-codierten Eintrag

Sie können das JSON-Format verwenden, um Daten in Ihren Kanal zu schreiben. Dieses Beispiel zeigt einen JSON-formatierten REST-Aufruf zum gleichzeitigen Schreiben mehrerer Felder und Statusinformationen. Die Antwort ist ebenfalls JSON-formatiert.

POST api.thingspeak.com/update.json
Content-Type: application/json
 
{ 
        "api_key": "XXXXXXXXXXXXXXXX"  
        "created_at": "2018-04-23 21:36:20 +0200", 
        "field1": "John Johnson", 
        "field3": 56, 
        "field4": 555, 
        "field5": 444, 
        "latitude": "", 
        "longitude": "", 
        "status": "Please check in!" 
    
}

Die Antwort ist ein JSON-Objekt des neuen Eintrags und ein 200 OK vom Server.

{
    "channel_id": 12345,
    "created_at": "2018-04-23 21:36:20 +0200", 
    "field1": "John Johnson", 
    "field3": 56, 
    "field4": 555, 
    "field5": 444, 
    "latitude": "", 
    "longitude": "", 
    "status": "Please check in!" 
}

Siehe auch

Read Data | Read Field | Read Status | Bulk Write Data

Themen

• Kanaleigenschaften