Hauptinhalt

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

Read Status of Image Request

Status der Bildanforderung mit HTTP GET lesen

Lesen Sie den Status einer kürzlich erfolgten Bildschreib- oder Löschanforderung, damit Sie feststellen können, ob die Anforderung abgeschlossen wurde.

Anfrage

HTTP-Methode

GET

URL

https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status

URL-Parameter

NameBeschreibung

<channel_id>

(Erforderlich) Kanal-ID für den gewünschten Kanal.

<request_id>

(Erforderlich) Anforderungs-ID, die von der ursprünglichen Anforderung zurückgegeben wurde.

Beispiel: https://data.thingspeak.com/channels/0987654321/recent-requests/cl2th2wxyuvtsr7m9e3l5blje/status

Körperparameter

Keiner.

Überschriften

Keiner.

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

Die unmittelbare Antwort ist ein JSON-Objekt mit der ursprünglichen Anforderungs-ID sowie dem aktuellen Code und Status. Zum Beispiel:

{
    "requestID": "cl2th2wxyuvtsr7m9e3l5blje",
    "code": 1,
    "status": "OK"
}

Mögliche Statuswerte sind PENDING, OK und FAIL.

Wenn der Status FAIL ist, gibt es auch ein message-Feld, das mit dem Grund für den Anforderungsfehler ausgefüllt wird.

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

alle erweitern

Sie können Ihren Webbrowser verwenden, um GET-HTTP-Anfragen an die RESTful-API für ThingSpeak™ abzuschließen.

Um das Format einer HTTP-Antwort anzuzeigen, kopieren Sie diesen Link in Ihren Webbrowser und ändern Sie die Kanal-ID und die Anforderungs-ID entsprechend.

https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status

Der folgende Code wird in einer Linux®-Shell ausgeführt. Ändern Sie die Anforderungs-ID der Kanal-ID entsprechend.

curl --location --request GET 'https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status'

Die Rohantwort lautet etwa:

{"requestID":"cl2tgo098765432193z93gpc1","code":1,"status":"OK"}

Sie können Postman verwenden, um HTTP-DELETE-Anfragen mithilfe der RESTful-API für ThingSpeak zu senden. Dieses Beispiel zeigt, wie Sie eine Reihe von Bildern innerhalb eines Zeitstempelbereichs löschen.

  1. Wählen Sie in Postman GET aus der Dropdownliste der HTTP-Verben aus.

  2. Geben Sie in der Adressleiste https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status ein und ersetzen Sie <channel_id> durch die ID des Bildkanals und <request_id> durch die Anforderungs-ID der Anfrage, nach der Sie fragen.

  3. Unter den Registerkarten Params und Headers sind keine Schlüssel erforderlich, und der Inhalt von Body ist none.

Dieses Bild zeigt das Postman-Setup für die Statusanfrage und das Ergebnis.

Postman status request

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