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>`	发布图像的时间戳来源。`ingest` 或 `client`。
`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&start=2022-02-22T22:22:22.2222+05:00&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"
}

错误

完整列表请参阅错误代码。

示例

全部展开

使用 cURL 删除图像

以下代码在 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 删除图像

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

在 Postman 中，从 HTTP 动词下拉列表中选择 DELETE。
在地址栏中输入 https://data.thingspeak.com/channels/<chanID>/images，将 <chanID> 替换为要删除图片的通道 ID。
在 Params 选项卡下，输入以下参数键和适当的值。
- timestamp
- start
- end
在 Headers 选项卡下，输入参数键 thingspeak-image-channel-api-key 及其来自图像通道 API 密钥的值，该密钥可以在 Channels > My Image Channels 列表中找到。
在 Body 选项卡下，选择 none。