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

espandi tutto nella pagina

Leggi lo stato di una recente richiesta di scrittura o eliminazione di un'immagine, così puoi stabilire 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 del 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 suo codice e stato attuali. 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 che viene compilato con il motivo del fallimento della richiesta.

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

espandi tutto

Puoi utilizzare il tuo browser web per completare le richieste HTTP GET 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 opera in una shell Linux®. Modificare l'ID della richiesta dell'ID canale come appropriato.

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

La risposta grezza è più o meno così:

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

È possibile utilizzare Postman per inviare richieste HTTP DELETE tramite l'API RESTful per ThingSpeak. Questo esempio mostra come eliminare un set di immagini all'interno di un intervallo di timestamp.

  1. In Postman, seleziona 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 su cui stai effettuando la richiesta.

  3. Non sono richieste chiavi nelle schede Params e Headers e il contenuto di 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.

Vedi anche

|