# 查询消息通知服务器 IP (/zh-CN/api-reference/api-ref/rtmp-gateway/query-ip-address) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 查询声网消息通知服务器的 IP 地址。 - OpenAPI: /openapi/media-gateway/media-gateway.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/ 查询消息通知服务器的 IP 地址或 IP 地址列表。 **背景**:开通消息通知服务后,声网消息通知服务可以将云端转码业务中的发生的一些事件以 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 地址。" } ] } } } ```