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

Write Image

Kanalbild mit HTTP POST schreiben

alle in Seite erweitern

Anfrage

HTTP-Methode

POST

URL

https://data.thingspeak.com/channels/<channel_id>/images/<filename>/<timestamp>

URL-Parameter

Name	Beschreibung
`<channel_id>`	(Erforderlich) Kanal-ID für den Bildkanal, in den geschrieben werden soll.
`<filename>`	(Optional) Name der Bilddatei.
`<timestamp>`	(Optional) Vom Client bereitgestellter Zeitstempel.

Beispiel:https://data.thingspeak.com/channels/123456/images/MVseg_01.jpg/2022-01-29T15:06:35.642Z

Körper

Der Hauptteil des POST besteht aus den Bilddaten. Die Art und Weise der Dateiangabe hängt vom Dienstprogramm ab.

Überschriften

Für eine Bild-POST-Anfrage sind die folgenden Header erforderlich.

Schlüsselname	Wert
`Content-type`	(Erforderlich) `image/jpeg`
`thingspeak-image-channel-api-key`	(Erforderlich) Der API-Schlüssel für diesen bestimmten Bildkanal. Der Write-API-Schlüssel befindet sich in der Spalte API Keys der Bildkanaltabelle.

Antwort

Erfolg

HTTP-Statuscode

202 OK

JSON-Antwort

Die Antwort ist ein JSON-Objekt des neuen Eintrags, zum Beispiel:

{
    "requestID": "cmnog8kdd00224cmc4cz0dnwo",
    "code": 0,
    "status": "PENDING",
    "message": null
}

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Einschränkungen

Zum Erstellen eines Bildkanals benötigen Sie eine kostenpflichtige Lizenz.
Das einzige unterstützte Bildformat ist JPEG/JPG.
Die Größe der Bilder ist auf 5 MB begrenzt. Die etwas größeren werden automatisch verkleinert. Deutlich größere Bilder werden abgelehnt.
Alle Zeitstempel müssen innerhalb eines Kanals eindeutig sein. Sie können kein neues Bild mit einem Zeitstempel schreiben, der mit dem Zeitstempel eines vorhandenen Bildes im Kanal übereinstimmt.

Beispiele

alle erweitern

Bild mit cURL schreiben

Der folgende Code wird in einer Linux^®-Shell ausgeführt. Ändern Sie die Kanal-ID, den API-Schlüssel und den Dateinamen entsprechend.

curl --location --request POST "https://data.thingspeak.com/channels/95b0766f76/images" \
--header "Content-Type: image/jpeg" \
--header "thingspeak-image-channel-api-key: M3I17NS05QKZ6Q5D" \
--data-binary "./MyImage44.jpg"

Die Rohantwort lautet:

{"requestID":"cl2t7ybd40ppo07k7fo2lbi83","code":0,"status":"PENDING"}

Verwenden Sie Postman, um Bilder 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 Sie mit Postman Daten in einen Kanal schreiben.

Wählen Sie in Postman POST aus der Dropdownliste der HTTP-Verben aus.
Geben Sie https://data.thingspeak.com/channels/<channel_id>/images in das Adressfeld ein und ersetzen Sie <channel_id> durch die ID des Kanals, in den Sie das Bild schreiben.
Geben Sie unter der Registerkarte Headers die folgenden Parameterschlüssel ein:
- Content-type mit dem Wert image/jpeg.
- thingspeak-image-channel-api-key durch den Wert aus Ihrem Bildkanal-API-Schlüssel, der in der Liste ThingSpeak™ Channels > My Image Channels verfügbar ist.
Wählen Sie unter der Registerkarte Body binary aus und klicken Sie dann auf Select File, um mit dem Datei-Explorer nach der Bilddatei zu suchen.
Klicken Sie auf Send, um Ihr Bild zu POSTEN. Die Antwort ist ein JSON-Objekt mit Anforderungs-ID, Code und Status sowie ein 202 Accepted vom Server.