Write Image
Scrivi l'immagine del canale con HTTP POST
Richiesta
Metodo HTTP
POST
URL
https://data.thingspeak.com/channels/
<channel_id>
/images/<filename>
/<timestamp>
Parametri URL
Nome | Descrizione |
---|---|
| (Obbligatorio) ID canale per il canale immagine su cui scrivere. |
<filename> | (Facoltativo) Nome del file immagine. |
<timestamp> | (Facoltativo) Timestamp fornito dal client. |
Esempio:https://data.thingspeak.com/channels/123456/images/MVseg_01.jpg/2022-01-29T15:06:35.642Z
Corpo
Il corpo del POST sono i dati dell'immagine. Il modo in cui specificare il file dipende dall'utilità.
Intestazioni
Le seguenti intestazioni sono necessarie per una richiesta POST di immagine.
Nome chiave | Valore |
---|---|
Content-type | (Obbligatorio) |
thingspeak-image-channel-api-key | (Obbligatorio) La chiave API per questo canale immagine specifico. La chiave API di scrittura si trova nella colonna API Keys della tabella dei canali immagine. |
Risposta
Successo
202 OK
La risposta è un oggetto JSON della nuova voce, ad esempio:
{ "requestID": "cmnog8kdd00224cmc4cz0dnwo", "code": 0, "status": "PENDING", "message": null }
Errori
Per l'elenco completo, vedere Codici di errore.
Limitazioni
È necessario disporre di una licenza a pagamento per creare un canale di immagini.
L'unico formato immagine supportato è JPEG/JPG.
Le immagini hanno una dimensione limitata a 5 MB. Quelli leggermente più grandi vengono automaticamente ridimensionati. Le immagini significativamente più grandi vengono rifiutate.
Tutti i timestamp devono essere univoci all'interno di un canale. Non è possibile scrivere una nuova immagine utilizzando un timestamp che corrisponda al timestamp di un'immagine esistente nel canale.