消息通知服务地址

构建时从公开 REST 接口定义的 `notifications` 标签生成：方法、路径、参数、请求体、响应与 curl。

由公开 REST 接口定义生成

版本 v1.1.0 · 更新于 2026-10-26 · 修订 1

分组概览

本页由公开 REST 接口定义在构建时生成：标签 notifications，共 2 个操作（全量 189 个）。鉴权、信封与分页约定见 REST API 总览.

方法	路径	摘要
`GET`	`/v1/ncs/ip`	Query the message notification service addresses (cloud recording spelling)
`GET`	`/v2/ncs/ip`	Query the message notification service addresses

Query the message notification service addresses (cloud recording spelling)

鉴权：项目凭证（customerId:customerSecret 的 Base64）

响应

状态码	说明 / schema
`200`	notification addresses — `object{ data }`
`400`	Invalid parameter — `Error`
`401`	Missing/invalid credentials — `Error`
`403`	Banned or service not enabled — `Error`
`404`	Resource not found — `Error`
`415`	Content-Type must be application/json — `Error`
`429`	Quota exceeded — `Error`

调用示例

bash

curl -s -X GET "$NIMEET_API_BASE/v1/ncs/ip" \
  -H "Authorization: Basic $NIMEET_CUSTOMER_BASIC"

Query the message notification service addresses

Returns the addresses this control plane delivers callbacks from; allow-list them if the receiving server is behind a firewall.

鉴权：项目凭证（customerId:customerSecret 的 Base64）

响应

状态码	说明 / schema
`200`	notification addresses — `object{ data }`
`400`	Invalid parameter — `Error`
`401`	Missing/invalid credentials — `Error`
`403`	Banned or service not enabled — `Error`
`404`	Resource not found — `Error`
`415`	Content-Type must be application/json — `Error`
`429`	Quota exceeded — `Error`

调用示例

bash

curl -s -X GET "$NIMEET_API_BASE/v2/ncs/ip" \
  -H "Authorization: Basic $NIMEET_CUSTOMER_BASIC"

Error — object{ code, message, reason, sdkCode, details }

字段	类型	必填	说明
`code`	`string`	是	stable machine code, see errors.json
`message`	`string`	是
`reason`	`string`
`sdkCode`	`integer`		Agora-aligned client error number
`details`	`object`