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

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

在调用输入在线媒体流 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` | [response-code-markdown-0-2-1 details](#table-slot-response-code-markdown-0-2-1) | 检查报错的字段是否符合 API 文档的描述。 |
| `401 Unauthorized` | Invalid authentication credentials. | 检查 [HTTP 基本认证](/zh-CN/realtime-media/media-pull/build/http-basic-auth)是否符合要求。 |
| `403 Forbidden` | [response-code-markdown-0-4-1 details](#table-slot-response-code-markdown-0-4-1) | 检查是否已[开通拉流服务](/zh-CN/realtime-media/media-pull/build/enable-service)。 |
| `404 Not Found` | Resource is not found and destroyed. | 使用[退避重试策略](/zh-CN/realtime-media/media-pull/build/rest-availability#使用退避重试策略)。 |
| `409 Conflict` | Resource with the same name already exists. | 删除已存在的同名云端播放器，然后重新请求创建。 |
| `429 Too Many Requests` | [response-code-markdown-0-7-1 details](#table-slot-response-code-markdown-0-7-1) | 超出配额限制，等待一段时间再重试。 |
| `500 Internal Server Error` | Some internal error happened. Contact us to help fix it. | 使用[退避重试策略](/zh-CN/realtime-media/media-pull/build/rest-availability#使用退避重试策略)。 |
| `503 Service Unavailable` | [response-code-markdown-0-9-1 details](#table-slot-response-code-markdown-0-9-1) | 使用[退避重试策略](/zh-CN/realtime-media/media-pull/build/rest-availability#使用退避重试策略)。 |
| `504 Gateway Timeout` | Gateway timeout. Query to check whether the player has been created, or to create another one instead. | 使用[退避重试策略](/zh-CN/realtime-media/media-pull/build/rest-availability#使用退避重试策略)。 |

<a id="table-slot-response-code-markdown-0-2-1"></a>

**response-code-markdown-0-2-1 details**

- Parameter 'streamUrl' is invalid formatted.
- Parameter channelName is invalid. Fix it in your request and retry.

<a id="table-slot-response-code-markdown-0-4-1"></a>

**response-code-markdown-0-4-1 details**

- This project has not enabled Cloud Player product yet. Contact us to enable it.
- This project's permission to use Cloud Player was revoked. Contact us for details.

<a id="table-slot-response-code-markdown-0-7-1"></a>

**response-code-markdown-0-7-1 details**

- Request rate limit exceeded.
- Resources quota limit exceeded.
- No available resources.

<a id="table-slot-response-code-markdown-0-9-1"></a>

**response-code-markdown-0-9-1 details**

- Service overload. Retry with back off strategy, and contact us to help fix it.
- Service unavailable temporarily. Retry with back off strategy.

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

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

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