Contenuto principale

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

Delete Image

Elimina l'immagine dal canale con HTTP DELETE

Richiesta

Metodo HTTP

DELETE

URL

https://data.thingspeak.com/channels/<channel_id>/images?timestamp=<timestamp_src>&start=<start_time>&end=<end_time>

Parametri URL

NomeDescrizione

<channel_id>

(Obbligatorio) ID del canale da cui rimuovere le immagini.

timestamp=<timestamp_src>

Fonte del timestamp in cui l'immagine è stata pubblicata. O ingest o client.

start=<start_time>

Inizio dell'intervallo di timestamp per le immagini da eliminare, nel formato

YYYY-MM-DDTHH:MM:SS.SSSS+HH:MM

end=<end_time>

Fine dell'intervallo di timestamp per le immagini da eliminare, nel formato

YYYY-MM-DDTHH:MM:SS.SSSS+HH:MM

Esempio: https://data.thingspeak.com/channels/95b0766f76/images?timestamp=ingest&amp;start=2022-02-22T22:22:22.2222+05:00&amp;end=2022-06-22T22:22:22.2222+05:00

Parametri del corpo

Nessuno.

Intestazioni

Per una richiesta DELETE di un'immagine sono necessarie le seguenti intestazioni.

Nome chiaveValore
thingspeak-image-channel-api-key

(Obbligatorio) La chiave API per questo specifico canale immagine. La chiave API di scrittura si trova nella colonna API Keys della vista dei canali immagine.

Risposta

Successo

Codice di stato HTTP

202 Accepted

Corpo

La risposta immediata è un oggetto JSON con ID, codice e stato della richiesta. Per esempio:

{
    "requestID": "cl2th2wxyuvtsr7m9e3l5blje",
    "code": 0,
    "status": "PENDING"
}

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

espandi tutto

Il codice seguente opera in una shell Linux®. Modificare l'ID del canale e altri parametri secondo necessità.

curl --location --request DELETE 'https://data.thingspeak.com/channels/95b0766f76/images?timestamp=ingest&start=2022-02-22T22:22:22.2222+05:00&end=2022-06-22T22:22:22.2222+05:00' \
--header 'thingspeak-image-channel-api-key: M3I17NS05QKZ6Q5D'

La risposta grezza è:

{"requestID":"cl2t7ybd40ppo07k7fo2lbi83","code":0,"status":"PENDING"}

È 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 DELETE dall'elenco a discesa dei verbi HTTP.

  2. Nella barra degli indirizzi, inserisci https://data.thingspeak.com/channels/<chanID>/images, sostituendo <chanID> con l'ID del canale contenente le immagini da eliminare.

  3. Nella scheda Params, immettere le seguenti chiavi dei parametri con i valori appropriati.

    • timestamp

    • start

    • end

  4. Nella scheda Headers, inserisci la chiave del parametro thingspeak-image-channel-api-key con il valore della chiave API del tuo canale immagine, che si trova nell'elenco Channels > My Image Channels.

  5. Nella scheda Body, seleziona none.

Questa immagine mostra i parametri per eliminare le immagini in un intervallo di quattro mesi

Postman query parameters for image delete

La risposta è un oggetto JSON e un 202 Accepted dal server.