Status and error codes

This page lists response status codes for Cloud Transcoding and Multi-bitrate streaming, along with their descriptions and recommended actions.

Cloud Transcoding

When you call the Cloud Transcoding REST API, you receive an HTTP response status code:

• If the HTTP status code is 2XX, the request is successful.
• If the HTTP status code is not 2XX, the request failed.

The following example shows a failed request:

// 400 Bad Request
{
  "message": "appid is invalid"
}

When using Cloud Transcoding, you may receive status codes that indicate the service status. Refer to the following table to understand their meanings and take appropriate action.

When using the Cloud Transcoding response status code for troubleshooting, keep the following in mind:

• If the request fails, do not perform logical processing based on the message field in the response body. Rely primarily on the status code for troubleshooting.
• If the troubleshooting methods in the table do not resolve the issue, contact technical support with the values of the X-Request-ID and X-Resource-ID fields in the response header.
• If you receive a 404 status code after a Create request has returned successfully and you have not called Delete, or if the transcoder remains idle beyond the idleTimeout value in the request, use a backoff algorithm. Retry at increasing intervals of 5, 10, and 15 seconds to call Query for confirmation.
• A 5XX response status code usually indicates an issue in the server response process. Use a backoff strategy for query requests, retrying at increasing intervals of 5, 10, and 15 seconds, or contact technical support.

Multi-Bitrate

When you call the Multi-Bitrate REST API, you receive an HTTP response status code:

• If the HTTP status code is 2XX, the request is successful.
• If the HTTP status code is not 2XX, the request failed.

The following example shows a failed request:

// 400 Bad Request
{
  "status": "string",
  "data": {},
  "message": "string"
}

When using Cloud Transcoding Multi-Bitrate, you may receive status codes that indicate the service status.