Main Content

Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale in inglese.

Read Status of Image Request

Lire l'état de la requête d'image avec HTTP GET

Lisez l'état d'une requête récente d'écriture ou de suppression d'image, afin de pouvoir déterminer si la requête a été traitée.

Requête

Méthode HTTP

GET

URL

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

Paramètres d'URL

NomDescription

<channel_id>

(Required) Channel ID for the channel of interest.

<request_id>

(Obligatoire) ID de requête, renvoyé par la demande d'origine.

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

Paramètres du corps de la requête

Aucun.

En-têtes

Aucun.

Réponse

Succès

Code HTTP Status

200 OK

Corps

La réponse immédiate est un objet JSON avec l'ID de requête d'origine, ainsi que son code et son état actuels. Par exemple:

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

Possible status values are PENDING, OK, and FAIL.

If the status is FAIL, there is also a message field that is populated with the reason for the request failure.

Erreur

For the full list, see Codes d'erreur.

Esempi

espandi tutto

You can use your web browser to complete GET HTTP requests to the RESTful API for ThingSpeak™.

Pour voir le format d'une réponse HTTP, copiez ce lien dans votre navigateur Web, en modifiant l'ID du canal et l'ID de requête, le cas échéant.

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

The following code operates in a Linux® shell. Modifiez l'ID de requête d'ID de canal , le cas échéant.

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

La réponse brute est quelque chose comme :

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

You can use Postman to send HTTP DELETE requests using the RESTful API for ThingSpeak. Cet exemple montre comment supprimer un ensemble d'images dans une plage d'horodatages.

  1. In Postman, select GET from the drop-down list of HTTP verbs.

  2. In the address bar, enter https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status, replacing <channel_id> with the ID of the image channel, and <request_id> with the request ID of the request you are inquiring about.

  3. There are no keys required under the Params and Headers tabs, and the Body content is none.

Cette image montre la configuration de Postman pour la requête d'état et son résultat.

Postman status request

The response is a JSON object, and a 200 OK from the server.