Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale 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 del canale immagine su cui scrivere.
`<filename>`	(Facoltativo) Nome del file immagine.
`<timestamp>`	(Facoltativo) Timestamp fornito dal cliente.

Esempio:https://data.thingspeak.com/channels/123456/images/MVseg_01.jpg/2022-01-29T15:06:35.642Z

Corpo

Il corpo del POST contiene i dati dell'immagine. Il modo in cui specificare il file dipende dall'utilità.

Intestazioni

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

Nome chiave	Valore
`Content-type`	(Obbligatorio) `image/jpeg`
`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 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

Per creare un canale immagini è necessario disporre di una licenza a pagamento.
L'unico formato immagine supportato è JPEG/JPG.
Le dimensioni delle immagini sono limitate a 5 MB. Quelle leggermente più grandi vengono automaticamente ridotte. 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 corrisponde al timestamp di un'immagine esistente nel canale.

Esempi

espandi tutto

Scrivi l'immagine con cURL

Il codice seguente opera in una shell Linux^®. Modificare l'ID del canale, la chiave API e il nome del file come 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 grezza è:

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

Utilizzare Postman per scrivere l'immagine 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, seleziona POST dall'elenco a discesa dei verbi HTTP.
Inserisci https://data.thingspeak.com/channels/<channel_id>/images nel campo indirizzo, sostituendo <channel_id> con l'ID del canale su cui stai scrivendo l'immagine.
Nella scheda Headers, immettere 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 nell'elenco ThingSpeak™ Channels > My Image Channels.
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 richiesta, codice e stato; e un 202 Accepted dal server.