销毁云端播放器

更新时间不可用

销毁指定云端播放器。

DELETE
https://api.sd-rtn.com/{region}/v1/projects/{appId}/cloud-player/players/{id}

Delete 方法用于在项目中销毁一个云端播放器。

说明

通过 Delete 销毁一个已经销毁过的云端播放器时,响应状态码也为 2XX。

鉴权

Basic Auth

声网输入在线媒体流 RESTful API 仅支持 HTTPS 协议。发送请求时,你需要使用声网提供的客户 ID 和客户密钥生成 Base64 编码凭证,并填入请求头部的 Authorization 字段中。详见实现 HTTP 基本认证。

路径参数

regionstring
必填

云端播放器所在的区域,必须与创建云端播放器设置的 region 一致。

appIdstring
必填

声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。

idstring
必填

云端播放器的 ID。

请求 Header

X-Request-IDstring

UUID(通用唯一识别码),标识本次请求。传入该字段后,声网服务器会在响应 Header 中返回该字段。声网推荐你对 X-Request-ID 赋值。如果不赋值,声网服务器会自动生成一个 UUID 传入。

响应

如果状态码为 2XX,则请求成功。

响应 Header

X-Request-IDstring

UUID(通用唯一识别码),标识本次请求。该值为本次请求 Header 中 X-Request-ID。如果请求出错,请在日志中打印出该值,排查问题。

X-Resource-IDstring

UUID(通用唯一识别码),标识本次请求销毁的云端播放器的 ID。

请求示例

Example Request
curl --request DELETE \
  --url "https://api.sd-rtn.com/:region/v1/projects/:appId/cloud-player/players/:id" \
  --header 'Authorization: Basic <credentials>' \
  --header 'X-Request-ID: <string>'

响应示例

如果状态码为 2XX,则请求成功。