获取场景地址列表

更新时间不可用

获取指定房间的场景地址列表。

GET
https://api.netless.link/v5/rooms/{uuid}/scenes

路径参数

uuidstring
必填

房间的 UUID, 即房间的全局唯一标识符,可通过调用创建房间 API 或获取房间信息 API 获取。

查询参数

sceneDirstring

场景组的路径地址,以 / 开头。如果填入该参数,则返回指定场景组下的场景地址列表;如果不填,则返回当前所在场景组下的场景地址列表。

请求 Header

regionstring
必填

指定处理该请求的数据中心,取值如下:

  • cn-hz:中国杭州,服务区覆盖中国大陆地区及其他数据中心未覆盖的区域。

  • us-sv:美国硅谷,服务区覆盖北美洲、南美洲。

  • sg:新加坡,服务区覆盖新加坡、东亚、东南亚。

  • in-mum:印度孟买,服务区覆盖印度。

  • eu:欧洲(法兰克福),服务区覆盖欧洲。

tokenstring
必填

SDK Token,可以通过以下方式获取:

响应

若返回的状态码为 200 则表示请求成功。响应 Body 中包含包含 String 型的场景地址。

若返回的状态码不为 200 则表示请求失败。你可以参考响应状态码了解可能的原因。

响应 Body

response-200-application-jsonarray<string>

请求示例

Example Request
curl --request GET \
  --url "https://api.netless.link/v5/rooms/:uuid/scenes" \
  --header 'region: cn-hz' \
  --header 'token: <string>'

响应示例

[
  "/test/cover",
  "/test/page1"
]