响应状态码

在调用旁路推流 API 过程中，你可能收到如下 HTTP 响应状态码：

• 如果 HTTP 状态码为 2XX，则请求成功。

• 如果 HTTP 状态码不为 2XX，则请求失败。你可以根据对应的响应体中可能出现的 message 以及 reason 字段排查问题。

例如，请求失败时，你可能收到如下响应：

JSON

# 400 Bad Request
# 仅有 message
{
  "message": "appid is invalid"
}

JSON

# 403 Forbidden
# 仅有 reason
{
  "reason": "No invalid permission to use this function. Contact us."
}

下表介绍调用旁路推流 API 时，可能收到的响应状态码、message 或 reason 字段内容，以及相应的原因和建议措施。

状态码	可能的 message 或 reason 字段内容	原因	建议措施
200 OK	无该字段。	创建成功。	无需处理。
400 Bad Request	Invalid parameter: rtmpUrl. Replace it and retry. Invalid parameter: idleTimeout. Replace it and retry.	请求参数错误。	参考 HTTP 响应 Body 中的 reason 字段进行排查。
401 Unauthorized	Invalid authentication credentials.	RESTful API 认证失败。	重新进行 HTTP 基本认证。
403 Forbidden	No valid permission to use this function. Contact us.	未开通服务。	开通旁路推流服务。
404 Not Found	Resource is not found and destroyed.	并未成功启动推流任务、启动任务后中途退出、自动迁移中、正在销毁 Converter。	使用退避策略重试。
409 Conflict	Resource with the same name has already existed. Use the existing resource, otherwise delete it and create a new resource.	已存在相同名称的 Converter。	删除已有 Converter 并重新创建。
429 Too Many Requests	Request rate limit exceeded. Resource quota limit exceeded. No available resources.	并发请求过多，超出配额限制。	等待一段时间再请求。
500 Internal Server Error	Internal errors. Contact us for troubleshooting.	服务端内部错误。	使用退避策略重试。
501 Not Implemented	The method requested has not been implemented.	服务端内部错误。	使用退避策略重试。
503 Service Unavailable	The server is temporarily overloading. Retry with a backoff strategy and contact us for troubleshooting. The server is temporarily down. Retry with a backoff strategy.	服务端内部错误。	使用退避策略重试。
504 Gateway Timeout	Gateway timeout. Check whether the resource is created, if not, re-create a new resource.	服务端内部错误。	使用退避策略重试。

信息

如果以上排查方法并未解决问题，请务必在日志中打印出响应 Header 中的 X-Request-ID 和 X-Resource-ID 字段值，并请联系技术支持。

以下是一个排查问题的示例：

使用 Create 创建 Converter 时，如果响应状态码为 409(Conflict) ，message 为 "Resource with the same name already exists."，则代表本次请求想创建的 Converter 和已经创建的 Converter 名字（name）重复，响应头的 X-Resource-ID 字段为那个同名 Converter 的 ID。请检查并修改本次请求填写的 Converter 名字，然后重新创建 Converter。