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

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 を、ThingSpeak™ Channels > My Image Channels リストで入手できる画像チャネルAPI キーの値に置き換えます。

    Postman image post headers

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

    Postman image post body

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

    Postman image post response

参考

|

トピック