Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

Write Image

Écrire l'image du canal avec HTTP POST

développer tous les éléments de la page

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.

Exemple :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`	(Obligatoire) `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

Pour la liste complète, voir 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.

Exemples

développer tout

Écrire une image avec cURL

Le code suivant fonctionne dans un shell Linux^®. 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

Vous pouvez utiliser Postman pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment écrire des données sur un canal à l'aide de Postman.

Dans Postman, sélectionnez POST dans la liste déroulante des verbes HTTP.
Entrez https://data.thingspeak.com/channels/<channel_id>/images dans le champ d'adresse, en remplaçant <channel_id> par l'ID du canal sur lequel vous écrivez l'image.
Sous l' onglet Headers, saisissez les clés de paramètre suivantes :
- Content-type avec la valeur image/jpeg.
- thingspeak-image-channel-api-key avec la valeur de la clé API de votre canal d'image, disponible dans le ThingSpeak™ Channels > Liste .
Sous l'onglet Body, sélectionnez binary, puis cliquez sur Select File pour rechercher le fichier image avec l'explorateur de fichiers.
Cliquez sur Send pour POSTER votre image. La réponse est un objet JSON avec l'ID de demande, le code et le statut ; et un 202 Accepted du serveur.