Main Content

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

Read Status of Image Request

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

développer tous les éléments de la page

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>

(Obligatoire) ID du canal pour le canal d’intérêt.

<request_id>

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

Exemple : 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"
}

Les valeurs d'état possibles sont PENDING, OK et FAIL.

Si l'état est FAIL, il existe également un champ message qui contient la raison de l'échec de la demande.

Erreur

Pour la liste complète, voir Codes d'erreur.

Exemples

développer tout

Vous pouvez utiliser votre navigateur Web pour effectuer des requêtes HTTP GET auprès de l'API RESTful pour 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

Le code suivant fonctionne dans un shell Linux®. 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"}

Vous pouvez utiliser Postman pour envoyer des requêtes HTTP DELETE à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment supprimer un ensemble d'images dans une plage d'horodatages.

  1. Dans Postman, sélectionnez GET dans la liste déroulante des verbes HTTP.

  2. Dans la barre d'adresse, saisissez https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status, en remplaçant <channel_id> par l'ID du canal d'image, et <request_id> par l'ID de requête du canal d'image. demande qui vous intéresse.

  3. Aucune clé n'est requise sous les onglets Params et Headers, et le contenu Body est none .

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

Postman status request

La réponse est un objet JSON et un 200 OK du serveur.

Voir aussi

|