このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。

Write Image

HTTP POSTでチャネルイメージを書き込む

このページをすべて展開する

要求

HTTP メソッド

POST

URL

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

URLパラメーター

名前	説明
`<channel_id>`	(必須) 書き込む画像チャネルのチャネルID。
`<filename>`	(オプション) 画像ファイルの名前。
`<timestamp>`	(オプション) クライアントによって提供されたタイムスタンプ。

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

本文

POSTのbodyは画像データです。ファイルの指定方法はユーティリティによって異なります。

ヘッダー

画像 POST要求には次のヘッダーが必要です。

キー名	値
`Content-type`	(必須) `image/jpeg`
`thingspeak-image-channel-api-key`	(必須) この特定の画像チャネルの API キー。書き込み API キーは、イメージチャネルテーブルのAPI Keys列にあります。

対応

成功

HTTPステータスコード

202 OK

JSON応答

応答は、新しいエントリの JSON オブジェクトです。次に例を示します。

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

エラー

完全なリストについては、エラーコードを参照してください。

制限

画像チャネルを作成するには、有料ライセンスが必要です。
サポートされている画像形式は JPEG/JPG のみです。
画像のサイズは 5 MB に制限されています。少し大きいものは自動的に縮小されます。著しく大きな画像は拒否されます。
すべてのタイムスタンプはチャネル内で一意である必要があります。チャネル内の既存のイメージのタイムスタンプと一致するタイムスタンプを使用して、新しいイメージを書き込むことはできません。

例

すべて展開する

cURLで画像を書き込む

次のコードはLinux^®シェルで動作します。必要に応じて、チャネルID、API キー、ファイル名を変更します。

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"

生の応答は次のとおりです。

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

Postman を使用して POST でイメージを書き込む

Postmanを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。この例では、Postman を使用してチャネルにデータを書き込む方法を示します。

Postman で、HTTP 動詞のドロップダウンリストからPOSTを選択します。
アドレスフィールドに「https://data.thingspeak.com/channels/<channel_id>/images」と入力し、 <channel_id>をイメージを書き込むチャネルの ID に置き換えます。
「Headers」タブで、次のパラメーターキーを入力します。
- Content-typeの値はimage/jpegです。
- thingspeak-image-channel-api-key は、イメージチャネルAPI キーの値に置き換えます。これは、ThingSpeak™ Channels > My Image Channelsで入手できます。 $$リスト。
[Body]タブでbinaryを選択し、次にSelect Fileをクリックして、ファイルエクスプローラーでイメージファイルを参照します。
「Send」をクリックして画像を投稿してください。応答は、要求ID、コード、ステータスを含む JSON オブジェクトです。およびサーバーからの202 Accepted 。