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

Write Data

Kanaldaten mit HTTP GET oder POST aktualisieren

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 den API-Schlüssel für diesen bestimmten Kanal. Sie können den Write-API-Schlüssel auch mithilfe eines THINGSPEAKAPIKEY-HTTP-Headers senden. Der Write-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
created_at	(Optional) Datum, an dem der Feed-Eintrag erstellt wurde, im ISO 8601-Format, 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.	Datum/Uhrzeit

Inhaltstyp

Content-Type wird nur für die POST-Methode benötigt, 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, lautet 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 ™ abzuschließen. Beachten Sie, dass Sie bei eingebetteten Geräten oder Clients, die GET-Anfragen nicht automatisch URL-kodieren, die Abfrageparameter explizit URL-kodieren müssen, bevor Sie die GET-Anfrage vom Gerät aus stellen.

Kopieren Sie die URL in die Adressleiste Ihres Webbrowsers und ändern Sie <write_api_key> in Ihren Benutzer-API-Schlüssel, der sich unter 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 mit der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie Daten mit POSTMAN in einen Kanal geschrieben werden.

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 Dropdownliste 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 API-Schlüssel ein, der sich unter 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.

JSON-codierten Eintrag schreiben

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

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