错误代码

HTTP 状态	消息	详细信息	错误代码
400	错误的请求	由于语法错误，无法满足请求。请参阅REST API 参考以了解正确的语法。	`error_bad_request`
401	需要授权	身份验证详细信息不正确。提供正确的通道 API 密钥或用户 API 密钥。有关 API 密钥的信息，请参阅通道数据控制和 ThingSpeak API 密钥。	`error_auth_required`
402	需要付款	您已超出 ThingSpeak 许可证的消息限制。	`error_payment_required`
404	未找到资源	未找到请求的资源。请检查 URL 并重试。	`error_resource_not_found`
405	方法不允许	对此请求使用正确的 HTTP 方法。请参阅REST API 参考了解允许的方法。	`error_method_invalid`
409	冲突	该请求与目标资源的当前状态冲突。再次尝试您的请求或更改请求以解决冲突。	`error_conflict`
413	请求的实体太大	您的请求太大。减小尺寸并重试。	`error_request_too_large`
421	未执行任何操作	服务器尝试处理您的请求，但是没有可执行的操作。	`error_no_action`
422	无法处理的实体	请检查您的输入，以确保所有输入仅包含有效的 UTF-8 编码数据。	`error_invalid_byte_sequence`
429	请求过多	请等待，然后再发出另一个请求。有关具体的费率限制，请参阅如何购买和常见问题。	`error_too_many_requests`
500	内部服务器错误	遇到了意外情况。
502	错误的网关	服务器从上游服务器接收到无效响应。检查您的网络连接并重试。
503	暂停服务	服务器不可用或无法处理您的请求。稍后再尝试您的请求。

所有错误均与其相应的 HTTP 状态代码一起发送。

有关更多信息，请参阅 ThingSpeak Arduino、ESP8266 和 ESP32 的通信库中的“返回代码”。

文本

示例错误响应：error_auth_required。

JSON

响应是一个 JSON 错误对象，例如：

{
  "status": "401",
  "error":
  {
    "error_code": "error_auth_required",
    "message": "Authorization Required",
    "details": "Please make sure that your API key is correct."
  }
}

XML

响应是一个 XML 错误对象，例如：

<?xml version="1.0" encoding="UTF-8"?>
<error>
  <error-code>error_auth_required</error-code>
  <message>Authorization Required</message>
  <details>Please make sure that your API key is correct.</details>
</error>