# 查询消息通知服务器 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" } ] } } } ```