Main Content

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

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

Body

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 に制限されています。少し大きいものは自動的に縮小されます。著しく大きな画像は拒否されます。

  • すべてのタイムスタンプはチャネル内で一意である必要があります。チャネル内の既存のイメージのタイムスタンプと一致するタイムスタンプを使用して、新しいイメージを書き込むことはできません。

すべて展開する

次のコードは、 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を使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。この例では、Postman を使用してチャネルにデータを書き込む方法を示します。

  1. Postman で、HTTP 動詞のドロップダウン リストからPOSTを選択します。

  2. アドレスフィールドに「https://data.thingspeak.com/channels/<channel_id>/images」と入力し、 <channel_id>をイメージを書き込むチャネルの ID に置き換えます。

  3. Headers」タブで、次のパラメーターキーを入力します。

    • Content-typeの値はimage/jpegです。

    • thingspeak-image-channel-api-key は、イメージチャネルAPI キーの値に置き換えます。これは、ThingSpeak™ Channels > My Image Channelsで入手できます。 $$リスト。

    Postman image post headers

  4. [Body]タブでbinaryを選択し、次にSelect Fileをクリックして、ファイル エクスプローラーでイメージ ファイルを参照します。

    Postman image post body

  5. Send」をクリックして画像を投稿してください。応答は、要求ID、コード、ステータスを含む JSON オブジェクトです。およびサーバーからの202 Accepted

    Postman image post response