Main Content

本页采用了机器翻译。点击此处可查看英文原文。

Delete Image

使用 HTTP DELETE 从通道中删除图像

请求

HTTP方法

DELETE

URL

https://data.thingspeak.com/channels/<channel_id>/images?timestamp=<timestamp_src>&start=<start_time>&end=<end_time>

URL 参数

名称描述

<channel_id>

(必需)要从中删除图像的通道的通道 ID。

timestamp=<timestamp_src>

图片发布时的时间戳来源。ingestclient

start=<start_time>

要删除的图像的时间戳范围的开始,格式为

YYYY-MM-DDTHH:MM:SS.SSSS+HH:MM

end=<end_time>

要删除的图像的时间戳范围结束,格式为

YYYY-MM-DDTHH:MM:SS.SSSS+HH:MM

示例: https://data.thingspeak.com/channels/95b0766f76/images?timestamp=ingest&amp;start=2022-02-22T22:22:22.2222+05:00&amp;end=2022-06-22T22:22:22.2222+05:00

主体参数

没有任何。

标头

图像 DELETE请求需要以下标头。

键名称
thingspeak-image-channel-api-key

(必需)此特定图像通道的 API 密钥。写入 API 密钥位于图像通道视图的 API Keys 列中。

响应

成功

HTTP 状态代码

202 Accepted

主体

立即响应是一个包含请求ID、代码和状态的 JSON 对象。示例:

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

错误

完整列表请参见 错误代码

示例

全部展开

以下代码在 Linux® shell 中运行。根据需要更改通道ID 和其他参数。

curl --location --request DELETE 'https://data.thingspeak.com/channels/95b0766f76/images?timestamp=ingest&start=2022-02-22T22:22:22.2222+05:00&end=2022-06-22T22:22:22.2222+05:00' \
--header 'thingspeak-image-channel-api-key: M3I17NS05QKZ6Q5D'

原始响应是:

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

您可以使用 Postman 使用 ThingSpeak 的 RESTful API 发送 HTTP DELETE 请求。此示例演示如何删除时间戳范围内的一组图像。

  1. 在 Postman 中,从 HTTP 动词的下拉列表中选择 DELETE

  2. 在地址栏中输入https://data.thingspeak.com/channels/<chanID>/images,将<chanID>替换为要删除图像的通道ID。

  3. Params 选项卡下,输入以下参数键和适当的值。

    • timestamp

    • start

    • end

  4. Headers 选项卡下,输入参数密钥 thingspeak-image-channel-api-key 以及图像通道API 密钥中的值,该值可在 Channels 中找到>My Image Channels 上市。

  5. Body 选项卡下,选择 none

此图显示了删除四个月范围内图像的参数

Postman query parameters for image delete

响应是一个 JSON 对象,以及来自服务器的 202 Accepted