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 发布您的图像。响应是一个包含请求 ID、代码和状态的 JSON 对象；以及来自服务器的 202 Accepted。