# 响应状态码 (/zh-CN/realtime-media/transcoding/reference/response-code)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## 云端转码 [#云端转码]

本文提供云端转码和观众端多码率的响应状态码。

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

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

- 如果 HTTP 状态码不为 2XX，则请求失败。

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

```json
# 400 Bad Request
{
  "message": "appid is invalid"
}
```

下表展示使用云端转码服务发起请求时，你可能会收到的所有响应状态码、对应的含义以及建议措施：

| 状态码                  | 含义                               | 建议措施                                                         |
| ----------- | -------------------- | -------------------------------- |
| `200 OK`                | 请求成功。                         | 无需排查。                                                   |
| **废弃** `201 Created`  | 任务已经在进行中，请勿用同一个 `builderToken` 重复开启任务。 | 无需排查。  |
| `202 Accepted`          | 服务端已经收到任务请求，但不代表执行完成。 | 因为不确定请求是否执行完成，所以建议通过 [`Query`](/zh-CN/api-reference/api-ref/cloud-transcoding/query) 方法查询执行状态，再进行下一步业务操作。 |
| `400 Bad Request`       | 请求的语法错误。可能是参数取值不符合要求，也可能是你的 App ID 未开通云端转码服务。 | 请结合响应 Body 中的 `message` 字段进一步排查。 |
| `401 Unauthorized`      | 用于 HTTP 基本认证的 `Authorization` 字段无效。 | 参考[实现 HTTP 基本认证](/zh-CN/realtime-media/transcoding/build/http-auth#实现-http-基本认证)检查你的 `Authorization` 字段。 |
| `403 Forbidden`         | 你的 App ID 尚未开通云端转码服务。 | 请联系[技术支持](https://ticket.shengwang.cn)开通。          |
| `404 Not Found`         | 找不到 transcoder。          | 使用退避策略进行查询请求，确认 transcoder 是否创建成功。    |
| `409 Conflict`          | 已存在重名 `instanceId` 的 transcoder 任务。 | 如果你想创建新的 transcoder，请先将旧的 transcoder 删除。 |
| `429 Too Many Requests` | 请求速率超过上限。                 | 等待一段时间后再重试。     |
| `500 Internal Server Error`           | 声网服务器内部错误。               | 使用退避策略进行查询请求或联系技术支持。                           |
| `501 Not Implemented`   | 该方法未实现。                     | 无需排查。                                               |
| `503 Service Unavailable` | 声网服务器暂时超载或在临时维护中。 | 使用退避策略进行查询请求或联系技术支持。 |
| `504 Gateway Timeout`   | 声网服务器内部错误，充当网关或代理的服务器未从上游服务器获取请求，上游服务器已关闭。 | 使用退避策略进行查询请求或联系技术支持。 |

使用云端转码响应状态码进行问题排查时，你需要了解如下注意事项：

- 如果请求失败，不要对响应 Body 里的 `message` 字段的内容做任何逻辑处理，建议主要对状态码做逻辑处理。
- 如果以上表格中的排查方法并未解决问题，请务必在日志中打印出响应 Header 中的 `X-Request-ID` 和 `X-Resource-ID` 字段值，并请[联系技术支持](https://ticket.shengwang.cn/)。
- 收到 `404` 的状态码后，如果 [`Create`](/zh-CN/api-reference/api-ref/cloud-transcoding/create) 请求已返回成功且没有主动调用 [`Delete`](/zh-CN/api-reference/api-ref/cloud-transcoding/destroy) 方法，或者 transcoder 的空闲状态超过请求参数中的 `idleTimeout` 字段，建议采取退避算法（例如间隔 5 秒、10 秒、15 秒）调用 `Query` 方法进行确认。
- 收到 `5XX` 的响应状态码后，一般是服务端在响应的过程中出现了问题，建议操作如下：
    - 使用退避策略进行查询请求：例如间隔 5 秒、10 秒、15 秒进行 `Query` 请求，查询服务状态。
    - 联系技术支持。

## 观众端多码率 [#观众端多码率]

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

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

- 如果 HTTP 状态码不为 2XX，则请求失败。

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

```json
# 400 Bad Request
# 可能没有 status 或 data
{
  "status": "string",
  "data": {
    ...
  },
  "message": "string"
}
```

下表展示使用观众端多码率服务发起请求时，你可能会收到的所有响应状态码、对应的含义以及建议措施：

| 状态码 | 含义 | 建议措施 |
| --------- | --- | ------- |
| `200 OK`     | 操作成功。 | 无需排查。 |
| `400 Bad Request` | 请求无效。 | 检查请求参数是否合法。 |
| `401 Unauthorized` | 鉴权无效。 | 检查用于 HTTP 认证的 `Authorization` 字段是否正确。详见[实现 HTTP 鉴权](/zh-CN/realtime-media/transcoding/build/http-auth)。 |
| `404 Not Found` | 请求的资源未找到。 | 检查 `appid` 或者 `codecId` 字段是否正确。 |
| `415 Unsupported Media Type` | 不支持的媒体类型。 | 检查请求 Header 中的 `Content-Type` 字段是否设为 `application/json`。 |
| `429 Too Many Requests` | 请求过于频繁。 | 等待一段时间后再重试。 |
| `500 Internal Server Error` | 服务器内部错误。 | 尝试重试几次。 |

:::info[信息]
如果以上排查方法并未解决问题，请务必在日志中打印出响应 Header 中的 `X-Request-ID` 和 `X-Resource-ID` 字段值，并请[联系技术支持](https://ticket.shengwang.cn/)。
:::