# 查询消息通知服务器 IP (/zh-CN/api-reference/api-ref/rtc/query-ip-address)

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

查询声网消息通知服务器的 IP 地址。

- OpenAPI: /openapi/rtc/channel-management.zh-CN.yaml
- Operation ID: get-v2-ncs-ip
- Method: GET
- Path: /v2/ncs/ip
- Endpoint: https://api.sd-rtn.com/v2/ncs/ip

## Servers

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

在使用声网实时音视频功能时，你可以使用声网消息通知服务接收实时音视频业务中的频道状态。

开通消息通知服务后，当订阅的频道事件发生时，声网消息通知服务器会将事件通知投递给你的消息接收服务器。

如果你的消息接收服务器受防火墙限制，你可以调用该方法查询声网消息通知服务器的 IP 地址，并将获取到的所有 IP 地址都添加到防火墙白名单。


:::warning[注意]
声网可能会调整消息通知服务器的 IP 地址。强烈建议你至少每 24 小时查询一次，并自动更新防火墙配置，否则可能会影响你接收通知。
:::

## Authorization

This endpoint requires authentication.

- `Basic Auth`

## Parameters

No parameters.

## Request body

No request body.

## Responses

### 200

如果状态码为 200，则请求成功。

- `data` (object)
  - `data.service` (object)
    - `data.service.hosts` (array)
      - `data.service.hosts.items` (object)
        - `data.service.hosts.items.primaryIP` (string) - 声网消息通知服务器的 IP 地址。收到响应时，你仅需关心该字段，并将 IP 地址（或 IP 地址列表）添加到白名单中。
### 非 200

如果状态码不为 200，则请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/rtc/reference/response-code)排查问题。

No schema.

## Response examples

### 200

```json
{
  "data": {
    "service": {
      "hosts": [
        {
          "primaryIP": "xxx.xxx.xxx.xxx"
        },
        {
          "primaryIP": "xxx.xxx.xxx.xxx"
        }
      ]
    }
  }
}
```