Response status codes

After sending an HTTP request, the server will return a status code. Based on this status code, you can determine whether the request was successful and the reason for the possible failure:

• If the status code is 2XX, the request was successful.
• If the status code is not 2XX, the request has failed. Troubleshoot the problem based on the message field content in the response message body.

This page describes the status codes, the corresponding error reasons, and possible solutions.

Status code	Message example	Reason	Solution
200 OK	/	Request successful.	/
400 Bad Request	Invalid settings. Invalid 'channel' format. Streaming key exists in region:na.	Request parameter error.	Troubleshoot based on the specific content of the message field.
401 Unauthorized	Invalid authentication credentials.	RESTful API authentication has failed.	Retry HTTP basic or HMAC authentication.
403 Forbidden	Media Gateway is not enabled for this project. Contact us to enable. Stream does not belong to this app ID.	The Media Gateway service has not been activated. The queried streaming key does not belong to the corresponding app ID.	Contact technical support to activate the service. Check if the passed in streaming key and app ID match.
404 Not Found	Resource not found and destroyed.	The requested resource does not exist.	Check whether the passed in streaming key is correct.
409 Conflict	Resource with the same name already exists.	Too many concurrent requests.	Use a back-off strategy and try again. For example, wait for 1 second before trying again for the first time, then wait for 3 seconds to try for the second time, and 6 seconds for the third.
429 Too Many Requests	Request rate limit exceeded. Resources quota limit exceeded. No available resources.	Internal server error.	Use a back-off strategy and try again. For example, wait for 1 second before trying again for the first time, then wait for 3 seconds to try for the second time, and 6 seconds for the third.
500 Unknown	Internal error. Contact us to help fix it.	Internal server error.	Use a back-off strategy and try again. For example, wait for 1 second before trying again for the first time, then wait for 3 seconds to try for the second time, and 6 seconds for the third.
503 Service Unavailable	Service overload. Retry with the back-off strategy and contact us to fix it. Service unavailable temporarily. Retry with the back-off strategy.	Internal server error.	Use a back-off strategy and try again. For example, wait for 1 second before trying again for the first time, then wait for 3 seconds to try for the second time, and 6 seconds for the third.
504 Gateway Timeout	Gateway timeout. Query to check whether the player has been created, or to create another one instead.	Internal server error.	Use a backoff strategy and try again. For example, wait for 1 second before trying again for the first time, then wait for 3 seconds to try for the second time, and 6 seconds for the third.

Status code	Message example	Reason	Solution
200 OK	/	Request successful.	/
400 Bad Request	Invalid settings. Invalid template ID. Missing field: "transcoding.video.enabled" . Unsupported codec: "AV1".	Request parameter error.	Refer to the message field in the HTTP response body to troubleshoot.
401 Unauthorized	Invalid authentication credentials.	RESTful API authentication has failed.	Retry HTTP basic or HMAC authentication.
403 Forbidden	Media Gateway is not enabled for this project. Contact us to enable. Too many templates have been created.	The service has not been activated. Too many flow configuration templates have been created.	Contact technical support to activate Media Gateway. Delete unused flow configuration templates.
404 Not Found	Stream template not found.	The requested resource does not exist.	Check whether the passed in templateId is correct.
429 Too Many Requests	Request rate limit exceeded. Resources quota limit exceeded. No available resources.	Too many concurrent requests.	Try again with a back-off strategy.
500 Unknown	Internal error. Contact us to fix it.	Internal server error.	Try again with a back-off strategy.
502 Bad Gateway	Internal errors. Contact us to troubleshoot.	Internal server error.	Try again with a back-off strategy.
503 Service Unavailable	Service overload. Retry with the back-off strategy and contact us to fix it. Service unavailable temporarily. Retry with the back-off strategy.	Internal server error.	Try again with a back-off strategy.
504 Gateway Timeout	Gateway timeout. Query to check whether the task has been created, or to create another one instead.	Internal server error.	Try again with a back-off strategy.

Status code	Message example	Reason	Solution
200 OK	/	Request successful.	/
400 Bad Request	Invalid body. Invalid app ID. SID is missing.	Request parameter error.	Refer to the message field in the HTTP response body to troubleshoot.
401 Unauthorized	Invalid authentication credentials.	RESTful API authentication has failed.	Retry HTTP basic or HMAC authentication.
403 Forbidden	Media Gateway is not enabled for this project. Contact us to enable.	The service has not been activated.	Contact technical support to activate Media Gateway.
404 Not Found	/	The requested resource does not exist.	Please check whether the passed-in SID is correct.
429 Too Many Requests	Request rate limit exceeded. Resources quota limit exceeded. No available resources.	Too many concurrent requests.	Try again with a back-off strategy.
500 Unknown	Some internal error happened. Contact us to help fix it.	Internal server error.	Try again with a back-off strategy.
502 Bad gateway	Internal errors. Contact us for troubleshooting.	Internal server error.	Try again with a back-off strategy.
503 Service Unavailable	Service overload. Retry with a back-off strategy, and contact us to help fix it. Service unavailable temporarily. Retry with back off strategy.	Internal server error.	Try again with a back-off strategy.
504 Gateway Timeout	Gateway timeout. Query to check whether the task has been created, or to create another one instead.	Internal server error.	Try again with a backoff strategy.