# 查询消息通知服务器 IP (/zh-CN/api-reference/api-ref/media-push/get-ncs-ip)

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

查询消息通知服务器的 IP 地址或 IP 地址列表。

- OpenAPI: /openapi/media-push/media-push.zh-CN.yaml
- Operation ID: get-v1-ncs-ip
- Method: GET
- Path: /v1/ncs/ip
- Endpoint: https://api.sd-rtn.com/v1/ncs/ip

## Servers

- https://api.sd-rtn.com

**背景**：开通消息通知服务后，声网消息通知服务可以将旁路推流业务中发生的一些事件以 HTTPS 请求的方式通知到你的服务器。声网会动态调整消息通知服务器的 IP 地址，周期为 24 小时。

**用法**：你可以通过本方法查询 IP 地址。查询后，你需要将 IP 地址（或 IP 地址列表）添加到白名单中。


:::warning[注意]
我们强烈推荐你至少每 24 小时进行一次查询，并自动更新防火墙配置，否则可能会影响你接收通知。
:::

## Authorization

This endpoint requires authentication.

- `Basic Auth`

## Parameters

No parameters.

## Request body

No request body.

## Responses

### 2XX

如果返回的 HTTP 状态码为 `2XX`，表示请求成功。

你只需关心响应 Body 中的 `primaryIP` 字段，无需关心响应 Header 以及响应 Body 中的其他字段。

- `data` (object)
  - `data.service` (object)
    - `data.service.hosts` (array)
      - `data.service.hosts.items` (object)
        - `data.service.hosts.items.primaryIP` (string) - 声网消息通知服务器的 IP 地址。

## Response examples

### 2XX

```json
{
  "data": {
    "service": {
      "hosts": [
        {
          "primaryIP": "声网消息通知服务器的 IP 地址。"
        }
      ]
    }
  }
}
```