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

Write Image

Écrire l'image du canal avec HTTP POST

espandi tutto nella pagina

Requête

Méthode HTTP

POST

URL

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

Paramètres d'URL

Nom	Description
`<channel_id>`	(Obligatoire) ID de canal pour le canal d'image dans lequel écrire.
`<filename>`	(Facultatif) Nom du fichier image.
`<timestamp>`	(Facultatif) Horodatage fourni par le client.

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

Corps

Le corps du POST est constitué des données d'image. Le moyen de spécifier le fichier dépend de l'utilitaire.

En-têtes

Les en-têtes suivants sont requis pour une requête POST d'image.

Nom de la clé	Valeur
`Content-type`	(Required) `image/jpeg`
`thingspeak-image-channel-api-key`	(Obligatoire) La clé API pour ce canal d'image spécifique . La clé API d'écriture se trouve dans la colonne API Keys du tableau des canaux d'image.

Réponse

Succès

Code HTTP status

202 OK

Réponse JSON

La réponse est un objet JSON de la nouvelle entrée, par exemple :

{
    "requestID": "cmnog8kdd00224cmc4cz0dnwo",
    "code": 0,
    "status": "PENDING",
    "message": null
}

les erreurs

For the full list, see Codes d'erreur.

Limites

Vous devez disposer d'une licence payante pour créer une canal d'images .
Le seul format d'image pris en charge est JPEG/JPG.
Les images sont limitées en taille à 5 Mo. Ceux légèrement plus grands sont automatiquement réduits. Des images significativement plus grandes sont rejetées.
Tous les horodatages doivent être uniques au sein d'un canal. Vous ne pouvez pas écrire une nouvelle image en utilisant un horodatage qui correspond à l'horodatage d'une image existante dans le canal.

Esempi

espandi tutto

Écrire une image avec cURL

The following code operates in a Linux^® shell. Modifiez l'ID de canal , la clé API et le nom de fichier, le cas échéant.

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 réponse brute est :

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

Utiliser Postman pour écrire une image avec POST

You can use Postman to try out your HTTP requests using the RESTful API for ThingSpeak. Cet exemple montre comment écrire des données sur un canal à l'aide de Postman.

In Postman, select POST from the drop-down list of HTTP verbs.
Enter https://data.thingspeak.com/channels/<channel_id>/images in the address field, replacing <channel_id> with the ID of the channel you are writing the image to.
Under the Headers tab, enter the following parameter keys:
- Content-type with the value image/jpeg.
- thingspeak-image-channel-api-key with the value from your image channel API Key, which is available in the ThingSpeak™ Channels > My Image Channels listing.
Sous l'onglet Body, sélectionnez binary, puis cliquez sur Select File pour rechercher le fichier image avec l'explorateur de fichiers.
Click Send to POST your image. The response is a JSON object with request ID, code, and status; and a 202 Accepted from the server.