Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

Write Image

Scrivi l'immagine del canale con HTTP POST

espandi tutto nella pagina

Richiesta

Metodo HTTP

POST

URL

https://data.thingspeak.com/channels/<channel_id>/images/<filename>/<timestamp>

Parametri URL

Nome	Descrizione
`<channel_id>`	(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) `image/jpeg`
`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

Codice di stato HTTP

202 OK

Risposta JSON

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.

Esempi

espandi tutto

Scrivi immagine con cURL

Il codice seguente funziona in una shell Linux^® . Modificare l'ID del canale, la chiave API e il nome del file in modo appropriato.

curl --location --request POST "https://data.thingspeak.com/channels/95b0766f76/images" \
--header "Content-Type: image/jpeg" \
--header "thingspeak-image-channel-api-key: M3I17NS05QKZ6Q5D" \
--data-binary "./MyImage44.jpg"

La risposta raw è:

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

Usa Postman per scrivere immagini con POST

Puoi utilizzare Postman per provare le tue richieste HTTP utilizzando l'API RESTful per ThingSpeak. Questo esempio mostra come scrivere dati su un canale utilizzando Postman.

In Postman selezionare POST dall'elenco a discesa dei verbi HTTP.
Inserisci https://data.thingspeak.com/channels/<channel_id>/images nel campo dell'indirizzo, sostituendo <channel_id> con l'ID del canale su cui stai scrivendo l'immagine.
Nella scheda Headers , inserisci le seguenti chiavi di parametro:
- Content-type con il valore image/jpeg.
- thingspeak-image-channel-api-key con il valore della chiave API del tuo canale immagine, disponibile in ThingSpeak™ Channels > My Image Channels elenco.
Nella scheda Body seleziona binary, quindi fai clic su Select File per cercare il file immagine con Esplora file.
Fai clic su Send per PUBBLICARE la tua immagine. La risposta è un oggetto JSON con ID, codice e stato della richiesta; e un 202 Accepted dal server.