Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Error Codes

HTTP Status

Message

Details

Error Code

400

Bad Request

The request cannot be fulfilled due to bad syntax. See REST API for the correct syntax.

error_bad_request

401

Authorization Required

The authentication details are incorrect. Provide the correct channel API key or user API key. See Channel Data Control and ThingSpeak API Keys for information on API keys.

error_auth_required

404

Resource Not Found

The requested resource was not found. Check the URL and try again.

error_resource_not_found

405

Method Not Allowed

Use the proper HTTP method for this request. See REST API Reference for the allowed methods.

error_method_invalid

409

Conflict

The request is in conflict with the current state of the targeted resource. Try your request again or change the request to resolve the conflict.

error_conflict

413

Request Entity Too Large

Your request is too large. Reduce the size and try again.

error_request_too_large

421

No Action Performed

The server attempted to process your request, but has no action to perform.

error_no_action

429

Too Many Requests

Wait before making another request. See How to Buy and Frequently Asked Questions for specific rate limits.

error_too_many_requests

500

Internal Server Error

An unexpected condition was encountered.

 

502

Bad Gateway

The server received an invalid response from the upstream server. Check your network connection and try again.

 

503

Service Unavailable

The server was unavailable or unable to process your request. Try your request later.

 

All errors are sent with their corresponding HTTP status code.

Text

Example error response: error_auth_required.

JSON

The response is a JSON error object, for example:

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

XML

The response is an XML error object, for example:

<?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>