Main Content

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

Read Status of Image Request

使用 HTTP GET 读取图像请求的状态

读取最近的图像写入或删除请求的状态,以便您可以确定请求是否已完成。

请求

HTTP 方法

GET

URL

https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status

URL 参数

名称描述

<channel_id>

(必填)感兴趣通道的通道 ID。

<request_id>

(必需)请求 ID,从原始请求返回。

示例: https://data.thingspeak.com/channels/0987654321/recent-requests/cl2th2wxyuvtsr7m9e3l5blje/status

主体参数

无。

头文件

无。

响应

成功

HTTP 状态代码

200 OK

主体

立即响应是一个 JSON 对象,其中包含原始请求 ID 及其当前代码和状态。例如:

{
    "requestID": "cl2th2wxyuvtsr7m9e3l5blje",
    "code": 1,
    "status": "OK"
}

可能的状态值为 PENDINGOKFAIL

如果状态为 FAIL,则还会有一个 message 字段,其中填充了请求失败的原因。

错误

完整列表请参阅错误代码

示例

全部展开

您可以使用 Web 浏览器对 ThingSpeak™ 的 RESTful API 完成 GET HTTP 请求。

要查看 HTTP 响应的格式,请将此链接复制到您的 Web 浏览器,并根据需要更改通道 ID 和请求 ID。

https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status

以下代码在 Linux® shell 中运行。根据需要更改通道 ID 请求 ID。

curl --location --request GET 'https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status'

原始响应如下:

{"requestID":"cl2tgo098765432193z93gpc1","code":1,"status":"OK"}

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

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

  2. 在地址栏中输入 https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status,其中 <channel_id> 替换为图片通道的 ID,<request_id> 替换为您要查询的请求的请求 ID。

  3. ParamsHeaders 标签下不需要任何键,而 Body 内容是 none

该图显示了状态请求的 Postman 设置及其结果。

Postman status request

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