导出 (0) 打印
全部展开

媒体服务 REST API 开发的设置

更新时间: 2014年2月

Microsoft Azure Media Services 是一项服务,该服务接受基于 OData 的 HTTP 请求并能够以详细 JSON 或 atom+pub 做出响应。由于 媒体服务 遵循 Azure 设计准则,因此在连接到 媒体服务 时,每个客户端必须使用一组必需的 HTTP 标头,还可以使用一组可选标头。以下部分介绍你在创建请求和接收来自 媒体服务 的响应时可以使用的标头和 HTTP 谓词。

大致了解如何构建请求后,请参阅使用 Media Services REST API 连接到 Media Services了解有关访问令牌和媒体服务 URI 的信息。

每次调用 媒体服务 时,你必须在请求中包括一组必需标头,还可以根据需要包括一组可选标头。下表列出了必需的标头:

 

标头 类型

授权

持有者

持有者是唯一接受的授权机制。该值还必须包括由 ACS 提供的访问令牌。

x-ms-version

十进制

2.5

DataServiceVersion

十进制

3.0

MaxDataServiceVersion

十进制

3.0

note备注
由于 媒体服务 使用 OData 通过 REST API 公布其基础资产元数据存储库,因此任何请求中均应包括 DataServiceVersion 和 MaxDataServiceVersion 标头,但如果未包括这些标头,则当前媒体服务会假定使用的 DataServiceVersion 值为 3.0。

以下是一组可选标头:

 

标头 类型

日期

RFC 1123 日期

请求的时间戳

接受

内容类型

针对响应请求的内容类型如下所示:

  • application/json;odata=verbose

  • application/atom+xml

note备注
响应可能具有不同的内容类型,如 BLOB 提取,在该类型中成功的响应将包含 BLOB 流作为负载。

Accept-Encoding

Gzip、deflate

GZIP 和 DEFLATE 编码(如果适用)。注:对于大型资源,媒体服务可能会忽略此标头并返回未经压缩的数据。

Accept-Language

“en”、“es”等。

指定响应的首选语言。

Accept-Charset

字符集类型,如“UTF-8”

默认值为 UTF-8。

X-HTTP-Method

HTTP 方法

允许不支持 PUT 或 DELETE 等 HTTP 方法的客户端或防火墙使用这些方法(通过 GET 调用以隧道方式进行通信)。

Content-Type

内容类型

PUT 或 POST 请求中请求正文的内容类型。

client-request-id

字符串

调用方定义的值,用于标识给定请求。如果指定,将在响应消息中包括此值,作为一种映射请求的方法。

Important重要提示
值的上限应为 2096b (2k)。

以下是一组可能会返回给你的标头,具体取决于你所请求的资源和要执行的操作。

 

标头 类型

request-id

字符串

当前操作的唯一标识符,由服务生成。

client-request-id

字符串

调用方在原始请求(如果存在)中指定的标识符。

日期

RFC 1123 日期

处理请求的日期。

Content-Type

可变

响应正文的内容类型。

Content-Encoding

可变

Gzip 或 deflate(视情况而定)。

下面是在提出 HTTP 请求时可以使用的 HTTP 谓词的完整列表:

 

谓词 描述

GET

返回对象的当前值。

POST

根据提供的数据创建对象,或提交命令。

PUT

替换对象,或创建命名对象(如果适用)。

DELETE

删除对象。

MERGE

使用命名属性更改更新现有对象。

HEAD

为 GET 响应返回对象的元数据。

另请参阅

显示:
© 2014 Microsoft