Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch 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 sind die Bilddaten. Die Art und Weise, wie die Datei angegeben wird, hängt vom Dienstprogramm ab.

Überschriften

Die folgenden Header sind für eine Bild-POST-Anfrage erforderlich.

Schlüsselname	Wert
`Content-type`	(Erforderlich) `image/jpeg`
`thingspeak-image-channel-api-key`	(Erforderlich) Der API-Schlüssel für diesen spezifischen Bildkanal. Der Schreib-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

Sie benötigen eine kostenpflichtige Lizenz, um einen Bildkanal zu erstellen.
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 grobe Antwort 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 mithilfe der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie man mit Postman Daten in einen Kanal schreibt.

Wählen Sie in Postman POST aus der Dropdown-Liste 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, auf den Sie das Bild schreiben.
Geben Sie auf der Registerkarte Headers die folgenden Parameterschlüssel ein:
- Content-type mit dem Wert image/jpeg.
- thingspeak-image-channel-api-key mit dem Wert aus Ihrem Bildkanal-API-Schlüssel, der im ThingSpeak™ Channels > My Image Channels verfügbar ist-Auflistung.
Wählen Sie auf 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; und ein 202 Accepted vom Server.