13 设备客户机 Web 服务

Web 服务是基于 Web 的应用程序接口，客户机应用程序可通过这些接口访问远程服务中的数据。Content Delivery Server 提供了设备客户机 Web 服务以访问 Content Delivery Server 数据库中存储的信息。可以使用设备客户机 Web 服务验证订户，搜索、预览、购买和下载内容，访问订户的购买历史以及取消内容项订阅。

设备客户机 Web 服务提供了另外一种方法，以访问订户 API 并为订户创建客户机应用程序。该适配器提供了可用服务的概述。有关使用设备客户机 Web 服务的详细信息，请参见 $CDS_HOME/javadoc/webservices/subscriber/v1 中的 Javadoc 工具输出。有关配置 Content Delivery Server 以使用设备客户机 Web 服务的信息，请参见《Sun Java trademark System Content Delivery Server 5.1 集成和配置指南》中的第 1.11 节。

注 - 有关 Web 服务的教程不在本文档的范围之内。您可以从 Internet 的多个不同 Web 站点中获取有关编写使用 Web 服务的应用程序方面的信息。

可以使用以下 Web 服务：

验证

内容

设备

历史

语言环境

13.1 验证

验证 Web 服务处理验证订户的请求。任何客户机的首要任务是获得访问 Content Delivery Server 数据的授权。对于已知订户和匿名订户，验证 Web 服务将返回一个验证密钥。此密钥用于需要已验证订户的其他设备客户机 Web 服务。匿名用户可以使用设备客户机 Web 服务，但他们并不能使用所有的数据。

还可以使用验证 Web 服务更改订户的首选语言或设备，以及在不需要验证密钥时使其失效。

13.2 目录

目录 Web 服务处理以下请求：浏览或搜索内容以及获取系统中定义的内容类型。可以使用此 Web 服务获取类别中的内容，或者获取与搜索查询匹配的内容。仅返回基于订户计划向订户提供的内容。对于匿名用户，将使用默认订户计划。

13.3 内容

内容 Web 服务处理内容详细信息、预览、资源和二进制文件的请求。此 Web 服务还处理以下请求：购买内容项、在购买之前试用内容项或取消内容项订阅。可以使用此 Web 服务来管理订户与各个内容项和包之间的交互。匿名用户无法购买、试用、下载或取消订阅。

13.4 设备

设备 Web 服务处理以下请求：获取系统中定义的设备以及置备新的设备。可以按系统指定的设备 ID、用户代理或生产商来检索设备。也可以使用此 Web 服务来获取默认设备。

13.5 历史

历史 Web 服务处理订户购买历史的请求。可以使用此 Web 服务来确定订户是否购买了内容项，以及获取所购买的项和包的列表。匿名用户无法使用此 Web 服务。

13.6 语言环境

语言环境 Web 服务处理获取系统中定义的语言环境的请求。可以使用此 Web 服务获取已知语言环境列表以及获取默认语言环境。