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 的主体是图像数据。指定文件的方式取决于实用程序。

标头

图像 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^® shell 中运行。根据需要更改通道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 发布您的图像。响应是一个 JSON 对象，包含请求ID、代码和状态；以及来自服务器的 202 Accepted。