查询消息通知服务器 IP

更新时间不可用

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

GET

https://api.sd-rtn.com/v1/ncs/ip

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

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

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

注意

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

鉴权

HTTP 基本认证：每次发送 HTTP 请求时，都必须在请求 Header 部填入 Authorization 字段。关于如何生成该字段的值，请参考实现 HTTP 基本认证。

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

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

Example Request

curl --request GET \
  --url "https://api.sd-rtn.com/v1/ncs/ip" \
  --header 'Authorization: Basic <credentials>'

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