Main Content

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

Read Status of Image Request

Leggi lo stato della richiesta di immagine con HTTP GET

Leggere lo stato di una recente richiesta di scrittura o eliminazione di immagini, in modo da poter determinare se la richiesta è stata completata.

Richiesta

Metodo HTTP

GET

URL

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

Parametri URL

NomeDescrizione

<channel_id>

(Obbligatorio) ID canale per il canale di interesse.

<request_id>

(Obbligatorio) ID richiesta, restituito dalla richiesta originale.

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

Parametri del corpo

Nessuno.

Intestazioni

Nessuno.

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

La risposta immediata è un oggetto JSON con l'ID della richiesta originale, il codice e lo stato correnti. Per esempio:

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

I possibili valori di stato sono PENDING, OK e FAIL.

Se lo stato è FAIL, è presente anche un campo message popolato con il motivo dell'errore della richiesta.

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

espandi tutto

È possibile utilizzare il browser Web per completare le richieste GET HTTP all'API RESTful per ThingSpeak™.

Per visualizzare il formato di una risposta HTTP, copia questo collegamento nel tuo browser web, modificando l'ID del canale e l'ID della richiesta come appropriato.

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

Il codice seguente funziona in una shell Linux® . Modificare l'ID richiesta dell'ID canale in modo appropriato.

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

La risposta raw è qualcosa del tipo:

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

È possibile utilizzare Postman per inviare richieste HTTP DELETE utilizzando l'API RESTful per ThingSpeak. Questo esempio mostra come eliminare una serie di immagini entro un intervallo di timestamp.

  1. In POSTMAN selezionare GET dall'elenco a discesa dei verbi HTTP.

  2. Nella barra degli indirizzi, inserisci https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status, sostituendo <channel_id> con l'ID del canale immagine e <request_id> con l'ID della richiesta del richiesta su cui stai chiedendo informazioni.

  3. Non sono richieste chiavi nelle schede Params e Headers e il contenuto Body è none.

Questa immagine mostra la configurazione di Postman per la richiesta di stato e il suo risultato.

Postman status request

La risposta è un oggetto JSON e un 200 OK dal server.