具体实施方式
在如下的描述中,在说明书和附图中自始至终都利用相同标号标记类似部分。附图的图形可能不成比例,某些组件可能以一般化的和示意性的形式示出,为了清楚和简洁起见,通过通用标记标识。
图1是允许使用公共应用程序编程接口(API)提供像音乐数据服务、照片数据服务、视频数据服务和社交联网数据服务那样的各式各样数据服务的联合数据服务装置和方法的系统100的图形。系统100可以用硬件或硬件和软件的适当组合体实现,以及可以是工作在像个人计算机、平板电脑、电话、电视机、立体音响系统、或其它适当系统那样的通用和专用处理平台上的一个或多个API。
如本文所使用,“硬件”可以包括离散组件、集成电路、专用集成电路、现场可编程门阵列、或其它适当硬件的组合体。如本文所使用,“软件”可以包括一个或多个对象、代理程序、线程、数行代码、子例程、单独软件应用程序、工作在两个或更多个软件应用程序中或在两个或更多个处理器上的两行或更多行代码或其它适当软件结构、或其它适当软件结构。在一个示范性实施例中,软件可以包括工作在像操作系统那样的通用软件应用程序中的一行或更多行代码或其它适当软件结构、和工作在专用软件应用程序中的一行或更多行代码或其它适当软件结构。如本文所使用,术语“耦合”及其同类术语可以包括物理连接(像电线、光纤、或通信介质那样)、虚拟连接(像通过数据存储设备的随机指定存储地点或超文本传送协议(HTTP)链路那样)、逻辑连接(像通过集成电路中的一个或多个半导体器件那样)、或其它适当连接。在一个示范性实施例中,通信介质可以是网络或其它适当通信介质。
系统100包括联合用户API116、内容API104、反馈API106、更新API108和设备API110、和通过通信介质120与设备112a到112n和通过通信介质122与数据服务端114a到114n交接的联合万维网服务端102。通信介质120和122可以是像专用高速数据连线那样的单独通信介质,或可以是相同通信介质或通信介质的组合体,以及可以是像公共交换电话系统或互联网那样的一种或多种有线通信介质、一种或多种无线通信介质、一种或多种光通信介质、一种或多种数字或模拟通信介质、或这些或其它通信介质的适当组合体。
联合万维网服务端102可以包括请求处理器、接口管理器、数据库抽象层、数据库(像服务数据、用户数据、历史数据、更新数据、设备数据或其它适当数据那样)、内容服务映射和其它适当功能。在一个示范性实施例中,请求处理器可以接收来自用户设备的请求,并且可以管理对请求的响应(像跟踪各个请求和与生成请求的设备相联系的地址那样)。接口管理器可以控制对可能要求响应从用户设备接收的请求的用户API116、内容API104、反馈API106、更新API108和设备API104的访问。数据库抽象层可以像防止未授权个人访问用户数据那样控制对数据库的访问。
内容API104可以通过联合万维网服务端102与设备112a到112n和数据服务端114a到114n交接,或也可以或可替代地实现成每一个与联合万维网服务端102、设备112a到112n、和数据服务端114a到114n的一个或多个交接的多个专用内容API。这种架构使数据服务端114a到114n含有定制软件或算法以便工作在系统100内的需要最小。
在一个示范性实施例中,设备112a可以通过联合万维网服务端102、用户API116、内容API104、反馈API106和更新API108与数据服务端114a到114n的任何一个交接。在这个示范性实施例中,像平板电脑那样具有用户界面的设备可以使用单个界面访问像音频数据服务提供商或视频数据服务提供商那样的数据服务。如本文更详细所述,用户可以使用他们的平板电脑登录到联合万维网服务端102托管的帐户,可以接收最适合平板电脑的用户界面,可以选择输送给平板电脑的数据的类型,以及可以以可以显示在平板电脑上的格式接收那种数据。
设备112a到112n可以包括提供客户控制器API、联合万维网服务控制器接口、联合万维网服务查询库和其它适当客户功能的客户应用程序。在一个示范性实施例中,该客户应用程序可以从网站(对于个人计算机)、从智能电话或平板电脑应用程序商店、或从其它适当地点获得。在另一个示范性实施例中,联合万维网服务查询库可以是消费万维网服务的C++库(通信层),而联合万维网服务控制器接口可以是客户控制器API的联合万维网服务控制器响应的数据抽象。
在另一个示范性实施例中,用户可以使用智能电话登录到万维网服务提供商102托管的帐户,以及可以接收允许用户选择像独立扬声器或电视机那样的不同设备、从所选数据服务端接收所选数据的用户界面。在这个示范性实施例中,用户可以选择要输送给独立扬声器的音频记录、要输送给电视机的视频记录、或要输送给其它适当设备(打印机、复印机、传真机)的其它适当数据(文本、图像)。这样,系统100使像智能电话、个人计算机或平板电脑那样的设备起像扬声器、立体音响系统、电视机、打印机、传真机或复印机那样的多个各式各样设备的通常遥控设备的作用。
图2是依照本公开的示范性实施例提供联合数据服务输送的算法的图形。算法200是具有公开的数据输入状态、数据处理状态、和数据输出状态的示范性算法,其中一个或多个处理平台在软件控制下工作以便执行公开的算法功能。
算法200从接收方法调用的202开始。如本文所更详细讨论,方法调用可以以具有需要数据字段和可选数据字段的预定数据格式包括数据。通过利用系统100的架构,不同API可以利用含有可以容易转换以便供其它API和其它方法调用使用的公用数据字段的方法调用,以便提供公开的互通性。该算法然后转到204。
在204中,确定是否存在方法调用的所需数据字段。如本文所更详细讨论公开,每种方法调用可以含有一个或多个预定所需数据字段,以便如果不存在所需数据字段,则该方法调用是不完全的。方法调用的所需数据字段可以通过查找相关数据表格或与可以包括在方法调用数据格式内的预定地点中的方法调用的标识符相联系的其它适当数据结构来确定。如果在204中确定不存在所需参数,则该算法转到生成适当出错消息的206。在一个示范性实施例中,该出错消息可以生成请求附加信息、选择(像设备选择或数据服务端选择那样)、或其它适当信息的用户显示。在另一个示范性实施例中,该出错消息可以是对联合万维网服务端102、用户API116、内容API104、反馈API106、更新API108或其它适当系统或设备的询问,其中对该询问的响应可以提供缺失参数,或者也可以或可替代地使用其它适当进程。
如果在204中确定存在所有所需参数,则该算法转到像使用内容API104那样、格式化对数据服务端的调用的208。在另一个示范性实施例中,像在用户正在配置他们的系统或选择选项的情况下那样,可以生成对用户API116、内容API104、反馈API106、更新API108或其它适当系统或设备的调用,或者也可以或可替代地实现其它适当功能。该算法然后转到210。
在210中,将调用发送给数据服务端,并接收对该调用的响应。在一个示范性实施例中,该调用可以包括对特定类型的数据(音频节目、视频节目)、内容的列表(艺术家或节目的列表)、或其它适当数据的请求。该算法然后转到212,在212中确定该响应是否包括出错消息。在一个示范性实施例中,该出错消息可以指示数据服务端不可用、用户没有所请求内容的授权、或其它适当出错消息。如果确定已接收到出错消息,则该算法转到生成适当出错消息的214。在一个示范性实施例中,该出错消息可以生成请求附加信息、选择(像新节目选择或新设备目的地那样)、或其它适当信息的用户显示。在另一个示范性实施例中,该出错消息可以是对联合万维网服务端102、用户API116、内容API104、反馈API106、更新API108或其它适当系统或设备的询问,其中对该询问的响应可以提供缺失参数,或者也可以或可替代地使用其它适当进程。否则,该算法转到216。
在216中,将数据格式化以便输送给设备。在一个示范性实施例中,该数据可以包括用户界面,其中将该数据格式化成用在用户界面模板中。在另一个示范性实施例中,该数据可以包括格式化成输送给扬声器、电视机、个人计算机或平板电脑的显示器、或其它适当设备的音频数据、视频数据、图像数据、文本数据和其它适当数据。该算法然后转到218,在218中将数据输送给设备。
在操作中,算法200使各式各样数据服务端和设备通过公共平台交接,该公共平台包括联合万维网服务端102、用户API116、内容API104、反馈API106和更新API108。算法200也可以或可替代地使用面向对象的编程来实现,其中根据面向对象的原则联系上面所公开和下面进一步详述的不同状态。下面所述的各种各样API以及相关方法可以在系统100的架构内以及与算法200一起用于提供本文讨论的功能。就这一点而言,如下对API和相关方法的讨论可以应用于系统100和算法200、以及其它适当系统和算法。
图3是依照本公开的示范性实施例为用户设备提供联合数据服务输送的算法300的图形。算法300是具有公开的数据输入状态、数据处理状态、和数据输出状态的示范性算法,其中一个或多个处理平台在软件控制下工作以便执行公开的算法功能。
算法300从302开始,在302中从用户设备访问联合万维网服务端。在一个示范性实施例中,用户设备可能含有起提供对联合万维网服务端的访问的作用的已安装客户系统。在另一个示范性实施例中,用户设备可以访问网站或其它资源,以及可以接收访问联合万维网服务端的初始配置。也可以或可替代地使用像本文更详细所述的那些那样的其它适当进程。该算法然后转到304。
在304中,确定设备。在一个示范性实施例中,像在设备含有现有客户系统的情况下那样,可以使用如本文所公开的适当方法从机器id中确定设备。在另一个示范性实施例中,可以通过向设备或用户询问设备类型数据来确定设备。在又一个示范性实施例中,可以为从用户接口设备访问的外设确定设备。也可以或可替代地使用其它适当方法或进程。该算法然后转到306。
在306中,访问设备API。在一个示范性实施例中,设备API可以是设备API110或其它适当设备API。该算法然后转到308。
在308中,确定设备的更新程序是否可用,是否需要安装,是否已经请求,或要不然是否需要访问。在一个示范性实施例中,可以执行设备API110的方法。如果确定设备的更新程序已存在,则该算法转到安装更新的310。在一个示范性实施例中,可以使用更新API108的方法来更新设备或执行如本文所公开的其它适当功能。该算法然后转到312。同样,如果在308中确定没有设备更新可用或不需要,则该算法转到312。
在312中,访问用户API。在一个示范性实施例中,可以像授权用户或执行如本文所公开的其它适当用户API116的方法那样访问用户API116。该算法然后转到314。
在314中,用户登录到联合万维网服务端。在一个示范性实施例中,可以如本文所公开地实现用户API116的用户授权或登录方法。该算法然后转到316。
在316中,访问内容API。在一个示范性实施例中,内容API可以是内容API104或其它适当内容API,以及可以实现如本文所公开的一种或多种内容API104的方法。该算法然后转到318。
在318中,接收用户选择。在一个示范性实施例中,用户选择可以是像通过使用如本文所公开的一种或多种内容API104的方法那样的内容选择或其它适当用户选择。该算法然后转到320。
在320中,确定是否生成错误。在一个示例性实施例中,该错误可以是,譬如,内容服务端、内容API、或其它适当系统响应内容选择生成的本文公开的错误之一。如果确定生成了错误,则该算法转到322,在322中生成出错消息。在一个示范性实施例中,可以生成显示在用户界面上、供系统100的操作人员复查的出错消息,或可以生成其它适当出错消息。该算法然后返回到318,终止,或可以使用如本文所公开的其它适当方法或过程。
如果在320中确定未生成错误,则该算法转到324,在324中为设备格式化数据。在一个示范性实施例中,可以由,譬如,内容服务端格式化内容数据以便输送给用户设备。在其它示范性实施例中,可以格式化内容数据以便输送给外围设备,可以生成用于用户界面显示的数据,或可以格式化响应用户选择的其它适当数据。该算法然后转到326。
在326中,将数据输送给设备。在一个示范性实施例中,该数据可以包括像声音记录、电影、电视节目或其它适当音频或视频内容那样的音频或视频内容。在另一个示范性实施例中,该数据可以包括文本数据、图像数据、电话消息、传真发送内容、打印作业或其它适当数据。该算法然后转到328。
在328中,确定是否需要或已经生成反馈。在一个示范性实施例中,该反馈可以包括有关输送的音频或视频内容的信息。在另一个示范性实施例中,该反馈可以包括用户输入反馈或其它适当数据。如果确定需要或已经生成反馈,则该算法转到访问反馈API的330。在一个示范性实施例中,反馈API106可以用于实现如本文所公开的相关方法,或可以实现其它适当反馈API方法或进程。该算法然后转到332。同样,如果在328中确定未生成或不需要反馈,则该算法转到332。
在332中,确定用户是否,譬如,通过选择退出命令或控制,通过暂停,或以其它适当方式已经退出。如果用户已经退出,则该算法转到334,要不然,该算法返回到318或其它适当状态。
在操作中,算法300使各式各样数据服务端和设备通过公共平台交接,该公共平台包括联合万维网服务端102、用户API116、内容API104、反馈API106和更新API108。算法300也可以或可替代地使用面向对象的编程来实现,其中根据面向对象的原则联系上面所公开和下面进一步详述的不同状态。下面所述的各种各样API以及相关方法可以在系统100的架构内以及与算法300一起用于提供本文讨论的功能。就这一点而言,如下对API和相关方法的讨论可以应用于系统100和算法200,以及其它适当系统和算法。
内容提供商拥有与其它系统通用的可变函数、参数、返回类型和进程,诸如简单对象访问协议(SOAP)、可扩展标记语言远程过程调用(XML PRC)和JavaScript对象表示法远程过程调用(JSON RPC)、和相对表达软件工具(REST)。另外,内容提供商拥有使万维网服务实现进一步复杂化的验证用户的可变方法。内容API104提供了与这些不同协议的统一接口。
在一个示范性实施例中,内容API104可以允许通过内容API REST接口,使用代理调用,以统一方式跨过不同数据服务端114a到114n地执行调用。REST是沿着HTTP开发的架构风格,可以用于客户机-服务器通信,而不是构建像SOPA或XML-PRC那样在客户机-服务器通信的顶部上的层。也可以或可替代地利用其它适当接口。
万维网服务调用在内容提供商之间可以不同,来自一个万维网服务端的调用可能不是另一个中的调用的基础,或简单地可能不存在。例如,检索顶轨的列表的万维网服务调用对专门从事于照片的内容提供商来说没有意义。由于这个原因,这样的调用将导致可以适当管理的映射错误。在内容提供商提供类似服务的状况下,映射错误可能不是显而易见的。内容API104采用的错误系统除了提供调查内容提供商的万维网服务之外,还允许适当管理不存在调用。
内容API方法
如下章节描述内容API104的方法和参数。由于内容API104的开放性质,来自调用的响应更多地取决于传递的参数而不是取决于调用的方法。下面是内容API104的方法和每种方法的可用参数的描述。虽然像伙伴密钥那样的一些参数总是需要的,但请求的意图将决定使用哪些参数以及将随调用而变。
内容API104的参数可以具有如下特性。
用户API方法
用户API116允许伙伴开发者代表用户创建和管理个人资料。除了存储有关用户的一般信息之外,用户个人资料通过采用密钥链模型管理多个内容提供商证书。用户API116用于访问像用户的音乐库、播放列表、收藏夹、朋友或其它适当数据那样的内容提供商用户数据。
用户API116也可以提供共享和加书签。可以允许用户创建书签和播放列表,以便迅速访问相关内容和共享内容。与可以是开放的、以便接纳各种各样内容提供商的内容API104不同,用户API116可以更像传统万维网服务地暴露方法和参数。
可以将签名用于用户API116的调用和使用会话密钥的调用。签名可以不用会话密钥(例如,SHA1(方法+有序参数+伙伴秘密)或使用会话密钥(例如,SHA1(方法+有序参数+伙伴秘密+会话密钥)来创建。可以将SHA1输出转换成十六进制格式。使用的方法可以是调用方法,例如,从内容API104中“获取”或从用户API116“登录”。有序参数可以是后面接着参数值的按参数密钥名称排序的每个参数的串联。
伙伴秘密可以是当接收到伙伴密钥时给予伙伴的私人令牌。会话密钥可以是从像注册、登录、获取会话和创建会话那样的用户验证调用返回的令牌。当需要进行调用时,可以将会话密钥添加到签名中。查询库可以自动创建签名并将签名添加到询问中。
在一个示范性实施例中,可以使用四种用户API116的方法返回会话:1)登记;2)登录;3)会话;4)会话添加。会话密钥可以是当对万维网服务作出调用时识别用户的唯一令牌。会话密钥可以在预定时间量之后到期。除了会话密钥之外,可以返回标记会话到期的协调通用时间(UTC)时间戳。当会话到期时,它不再有效,必须作出调用来检索新会话。假设应用程序适当地存储了用户的万维网服务用户名和授权令牌,则可以不用提示用户再次登录地进行这种调用。授权令牌可以是当用户进行登录时可以捕获的用户万维网服务密码的SHA1散列值。应用程序无需存储明文密码,因为除了登记之外没有一种功能需要它。
下面是示范性用户API116的方法的描述。在这个示范性实施例中一些用户API116的方法需要https,如果不安全的话,将导致错误响应。也可以或可替代地使用不需要https的其它适当实施例。
“登记”方法登记用户。一旦成功,就向新用户返回新会话。否则,返回适当错误。“登记”的HTTP方法是POST,以及“登记”需要https。POST是万维网使用的HTTP协议支持的请求方法,可以用在客户机需要作为请求的一部分将数据发送给服务器的时候,譬如,在上载文件或提交完全的表单的时候。与只将URL和首标发送给服务器的GET请求方法相反,POST请求还包括消息主体。这使得可以将任何类型的任意长度数据发送给服务器。参数是:
“登录”方法用于让用户登录。一旦成功,该登录就可以向用户返回当前有效会话,或如果用户的当前有效会话已过期,则返回新会话。否则,该登录可以返回适当错误。可以通过这种调用返回所有相关用户数据。“登录”的HTTP方法是GET,以及“登录”需要https。参数是:
名称 |
需要 |
说明 |
username |
是 |
用户的个人资料用户名。 |
auth |
是 |
用户的验证令牌,譬如,用户密码的SHA1散列值。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“退出”方法用于让用户退出,并除去用户的当前会话。“退出”的HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“更新”方法更新用户的个人资料信息。一旦成功,该更新将返回用户。
否则,该更新将返回适当错误。“更新”的HTTP方法是POST,以及“更新”需要https。参数是:
“密码更新”方法可以更新用户的密码。一旦成功,返回OK(成功)状态。一旦失败,返回FAIL(失败)状态。HTTP方法是POST,以及“密码更新”方法可能需要https。参数是:
“密码重置”方法重置用户的密码。可以发送带有临时密码的电子邮件消息。HTTP方法是POST,以及需要https。相关参数是:
名称 |
需要 |
说明 |
email |
是 |
用户的有效电子邮件。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“存在”方法检验一下以便确定用户名是否已被使用。相关HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
username |
是 |
要测试的用户名。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
“会话”方法可以检索用户会话。一旦成功,这种方法将返回当前有效会话,或如果用户的当前会话已过期,则返回新会话。否则,该方法将返回适当错误。这种方法不返回用户数据。使用的HTTP方法是GET,需要https,以及参数是:
名称 |
需要 |
说明 |
username |
是 |
用户的个人资料用户名。 |
auth |
是 |
用户的验证令牌,譬如,用户密码的SHA1散列值。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“会话添加”方法可以创建新用户会话。一旦成功,这种方法将向用户返回新会话。否则,该方法将返回适当错误。即使当前会话是有效的,这种方法也将盖写这个用户的当前会话。HTTP方法是GET,需要https,以及参数是:
名称 |
需要 |
说明 |
username |
是 |
用户的个人资料用户名。 |
auth |
是 |
用户的验证令牌,可以使用用户密码的SHA1散列值。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“服务”方法检索用户的内容服务。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“服务添加”方法添加内容提供商服务。一旦成功,将更新的用户服务列表返给用户。否则,返回适当错误。这种方法可以用在规定通过用户名和密码进行用户验证的地方。HTTP方法是POST,需要https,以及参数是:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
service username |
是 |
用户的服务用户名。 |
service password |
是 |
用户的服务密码。 |
service userid |
否 |
用户的服务id。 |
key |
否 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“服务添加”方法添加内容提供商服务。一旦成功,将更新的用户服务列表返给用户。否则,返回适当错误。这种方法可以用在规定用户验证的地方。HTTP方法是POST,需要https,以及参数是:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
oauth |
是 |
可以将这个参数设置成1。 |
service username |
否 |
用户的服务用户名。 |
service password |
否 |
用户的服务密码。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“服务除去”方法除去内容提供商服务。一旦成功,将更新的用户服务列表返给用户。否则,返回适当错误。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
service |
是 |
要除去的服务。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
用户可以使用万维网服务共享机制共享资源。“共享”方法可以获得与另一个用户的书签共享。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
id |
是 |
书签共享id。 |
username |
否 |
用户名。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“共享”方法根据不同准则获得用户的书签共享。HTTP方法是GET,以及参数是:
“共享添加”方法可以添加与另一个用户的书签共享。HTTP方法可以是POST,以及参数是:
名称 |
需要 |
说明 |
username |
是 |
与其共享的万维网服务用户名。 |
user service |
是 |
用户的服务。 |
service |
是 |
资源服务。 |
type |
是 |
资源类型。 |
id |
否 |
资源id,如果未设置名称或过滤词则可以需要它。 |
name |
否 |
资源名称,如果未设置名称或过滤词则可以需要它。 |
filter |
否 |
资源过滤词,如果未设置id或名称则可以需要它。 |
Context type |
否 |
资源背景类型。 |
cid |
否 |
资源背景id。 |
Context name |
否 |
资源背景名称。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“共享除去”方法除去书签共享。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
id |
是 |
共享id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“共享除去”方法根据不同准则除去书签共享。使用的HTTP方法是GET,以及参数是:
“书签”方法可以获得通过id指定的书签。HTTP方法是GET,以及参数是:
id |
是 |
书签id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“书签”方法返回所有用户书签。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
start |
否 |
开始索引。 |
count |
否 |
从开始索引开始返回的项目的数量。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“书签添加”方法添加书签。HTTP方法可以是POST,以及参数是:
名称 |
需要 |
说明 |
service |
是 |
服务来源。 |
type |
是 |
内容类型。 |
id |
否 |
内容id,如果未设置名称或过滤词则可以需要它。 |
name |
否 |
内容名称,如果未设置id或过滤词则可以需要它。 |
filter |
否 |
内容过滤词,如果未设置id或名称则可以需要它。 |
Context type |
否 |
内容背景类型。 |
Context id |
否 |
内容背景id。 |
Context name |
否 |
内容背景名称。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“书签除去”方法用于除去通过id指定的书签。HTTP方法是GET,以及参数是:
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“书签除去”方法除去所有用户的书签。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表”方法用于获得通过播放列表id指定的用户播放列表。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
pid |
是 |
播放列表id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表”方法获得用户的所有播放列表。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
start |
否 |
开始索引(默认值是0)。 |
count |
否 |
从开始索引(默认值是0)开始返回的播放列表的数量。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表添加”方法添加播放列表。HTTP方法是POST,以及参数是:
name |
是 |
播放列表名称。 |
description |
否 |
播放列表说明。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表除去”方法除去用户的播放列表。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
pid |
是 |
播放列表id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表除去”方法除去用户的所有播放列表。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表更新”方法更新用户播放列表。HTTP方法是POST,以及参数是:
名称 |
需要 |
说明 |
pid |
是 |
播放列表id。 |
name |
否 |
播放列表名称。 |
description |
否 |
播放列表说明。 |
order |
否 |
定义次序的播放列表id的顿号隔开列表。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表资源”或“播放列表渠道”方法用于更新用户播放列表。HTTP方法是POST,以及参数是:
名称 |
需要 |
说明 |
pid |
是 |
播放列表id。 |
start |
否 |
开始索引。 |
count |
否 |
从开始索引开始返回的项目的数量。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“播放列表资源添加”或“播放列表渠道添加”用于将渠道资源添加播放列表中。该资源可以具有“渠道”类型。HTTP方法是POST,以及参数是:
“播放列表资源除去”或“播放列表渠道除去”方法可以用于从播放列表中除去渠道资源。HTTP方法是GET,以及参数是:
名称 |
需要 |
说明 |
playlist resource id |
是 |
播放列表资源id。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
“设备添加”方法可以用于登记用户设备。参数是:
名称 |
需要 |
说明 |
Machine id |
是 |
唯一机器id。 |
Model id |
是 |
型号id。 |
Current version |
否 |
安装的设备软件版本。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“设备”方法用于获得像型号那样、用户设备的所需信息。参数是:
名称 |
需要 |
说明 |
Machine id |
是 |
用户设备id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“所有设备”方法用于获得所有登记的用户设备。参数是:
“设备更新”方法用于更新用户设备的信息。参数是:
名称 |
需要 |
说明 |
Machine id |
是 |
机器id。 |
version |
是 |
安装的设备软件版本。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“设备除去”方法用于注销用户设备。参数是:
名称 |
需要 |
说明 |
Machine id |
是 |
用户设备id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“所有设备除去”方法用于注销所有用户设备。参数是:
名称 |
需要 |
说明 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“所有队列”方法用于获取当前用户拥有的阵列的列表。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列获得”方法用于,譬如,为登记用户和队列拥有者获取队列元数据以便看一看元数据。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列添加”方法向成为队列拥有者的当前用户登记阵列。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Machine id |
是 |
唯一机器id。 |
Name |
否 |
队列名称。 |
description |
否 |
队列说明。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列更新”方法更新队列元数据。可以设置name或description。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
Name |
否 |
队列名称。 |
description |
否 |
队列说明。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列除去”方法为当前用户注销队列拥有权。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列用户”方法像在允许登记用户作出这种调用的情况下那样、提供登记到阵列中的用户的列表。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列用户添加”方法像在登记队列时登记了队列拥有者的情况下,或在允许队列拥有者作出这种调用的情况下那样、将用户登记到队列中。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
username |
是 |
用户的用户名。 |
Status |
否 |
用户的状态。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列用户更新”方法像在允许队列拥有者作出这种调用的情况下那样、更新队列用户状态。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
username |
是 |
用户的用户名。 |
Status |
是 |
用户的状态。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列用户除去”方法像在允许队列拥有者作出这种调用的情况下那样、除去登记在这个队列中的用户。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
username |
是 |
用户的用户名。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目”方法用于像在允许登记用户作出这种调用的情况下,当传递username参数,以便为这个用户返回队列中的项目时那样、列出队列中的项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
username |
否 |
用户的用户名。 |
Start |
否 |
开始索引。 |
Count |
否 |
从开始索引开始返回的项目的数量。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目历史”方法用于像在允许登记用户作出这种调用的情况下,当传递username参数,以便为这个用户返回队列中的项目时那样,列出队列历史中的项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
username |
否 |
用户的用户名。 |
Start |
否 |
开始索引。 |
Count |
否 |
从开始索引开始返回的项目的数量。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目等待”方法用于像在每个用户拥有单独等待队列的情况下,以及在允许登记用户作出这种调用的情况下,当传递username参数,以便为这个用户返回等待队列中的项目时那样,提供等待队列中的项目的列表。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
username |
否 |
用户的用户名。 |
Start |
否 |
开始索引。 |
Count |
否 |
从开始索引开始返回的项目的数量。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目除去”方法用于为当前用户除去队列中的项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“等待队列项目除去”方法为当前用户除去等待队列中的项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“所有队列项目除去”方法为当前用户除去与队列相关的的所有项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目头部”方法用于像在允许登记用户作出这种调用的情况下那样、获取阵列的头部项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目头部更新”方法用于像在允许登记用户作出这种调用的情况下那样、更新阵列的头部项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
Status |
否 |
头部队列项目的状态。 |
progress |
否 |
头部队列项目的进展。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目头部评价”方法像在允许登记用户作出这种调用的情况下那样、评价阵列的头部项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
Value |
是 |
评价值。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目入列”方法试图将项目添加队列中。像在允许登记用户作出这种调用的情况下那样,如果队列满了,则使项目入列到等待阵列中。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
resource |
是 |
资源字符串。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目出列”方法像在允许队列拥有者作出这种调用的情况下那样、使头部项目从队列中出列。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“队列项目除去”方法像在提交项目的用户或队列拥有者作出该调用的情况下那样、除去通过队列项目id指定的项目。HTTP方法是GET,以及相关参数是:
名称 |
需要 |
说明 |
Queue id |
是 |
队列id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
反馈API方法
反馈API106跟踪用户的动作。除了为用户分析提供数据之外,它还提供用户历史和图表的基础。“跟踪”方法跟踪用户动作。如果没有用户通过,则匿名跟踪动作,以及相关参数是:
名称 |
需要 |
说明 |
action |
是 |
正在跟踪的动作。 |
service |
是 |
资源服务。 |
type |
是 |
资源类型。 |
id |
否 |
资源id,如果未设置名称或过滤词则需要它。 |
name |
否 |
资源名称,如果未设置id或过滤词则需要它。 |
filter |
否 |
资源过滤词,如果未设置id或名称则需要它。 |
Context type |
否 |
背景类型。 |
Context id |
否 |
背景id。 |
Context name |
否 |
背景名称。 |
city |
否 |
城市。 |
state |
否 |
州代码。 |
cc |
否 |
国家代码。 |
country |
否 |
国家名称。 |
lat |
否 |
纬度。 |
long |
否 |
经度。 |
“历史”方法检查用户的历史。可以传递过滤词以便集中结果。参数包括:
名称 |
需要 |
说明 |
action |
否 |
过滤的动作。 |
service |
否 |
过滤的服务。 |
type |
否 |
过滤的类型。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
“聚集”方法是具有如下参数的反馈聚集器:
“错误添加”方法添加错误作为反馈,以及具有如下参数:
code |
是 |
错误代码。 |
Name |
是 |
错误名称。 |
Machine id |
否 |
设备机器id。可以是匿名的。 |
Messsage |
否 |
错误消息。 |
Trace back |
否 |
错误跟踪。 |
Key |
是 |
伙伴密钥。 |
“错误”方法获得如通过id指定的错误,以及具有如下参数:
名称 |
需要 |
说明 |
id |
是 |
动作id。 |
key |
是 |
伙伴密钥。 |
“错误”方法获得通过不同过滤词指定的错误,以及具有如下参数:
设备API方法
设备API110提供管理与像扬声器、蜂窝式电话、iPod或iPad那样的设备有关的数据的接口。“型号添加”方法添加设备型号,以及包括如下参数:
名称 |
需要 |
说明 |
name |
是 |
型号名称。 |
platform |
是 |
型号平台软件和硬件。 |
Hardware version |
是 |
型号发布硬件版本。 |
Software version |
是 |
型号发布软件版本。 |
Description |
否 |
型号说明。 |
Release date |
否 |
型号发布日期。 |
“型号”方法获得通过id指定的型号信息,以及具有如下参数:
名称 |
需要 |
说明 |
Model id |
是 |
型号id。 |
“所有型号”方法获得所有设备型号,以及具有如下参数:
名称 |
需要 |
说明 |
platform |
否 |
型号平台。 |
start |
否 |
开始索引。 |
count |
否 |
从开始索引开始返回的项目的数量。 |
“型号除去”方法用于除去通过id指定的设备,以及具有如下参数:
名称 |
需要 |
说明 |
Model id |
是 |
型号id。 |
更新API方法
更新API108提供对任何设备或应用程序检验是否存在更新,如果存在一个,则将下载URL包括到更新中的方法。例如,有可能经由苹果应用程序商店下载iOS应用程序更新,但更新API108仍然可以用于检验是否有更新可用并提供iTunes URL。还提供为设备或应用程序添加更新的方法。“检验”方法用于为设备或应用程序检验更新。使用的HTTP是GET,以及相关参数是:
名称 |
需要 |
说明 |
Model id |
否 |
设备型号id。 |
Model alias |
否 |
设备型号别名。 |
version |
是 |
设备或应用程序软件版本。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
用户设备用于“检验”方法的参数:
名称 |
需要 |
说明 |
Machine id |
否 |
机器id。 |
Model id |
否 |
设备型号id。 |
key |
是 |
伙伴密钥。 |
signature |
是 |
这种调用的签名。 |
错误
万维网服务端为错误响应返回预定错误代码。
与万维网服务接口有关的错误包括:
名称 |
说明 |
Mapping Error |
不能识别创建有效请求的方法或参数。 |
User Agent Error |
无效用户代理。 |
Secure Requent Error |
请求需要https。 |
Interface Error |
找不到请求的接口。 |
Method Error |
方法不可用于这个API。 |
Service Not Found Error |
找不到请求的服务。 |
Type Error |
请求的类型无效。 |
Api Key Error |
万维网服务密钥失效或无效。 |
Partner Service Error |
请求的服务对于这个伙伴来说失效或无效。 |
Signature Error |
签名核实失败。 |
Filter Error |
不能识别请求的过滤词。 |
Partner Not Found Error |
找不到伙伴。 |
与用户帐户和服务有关的用户错误包括:
与请求结果有关的错误包括:
Service Call Error |
服务调用失败。 |
No Results Error |
未为服务调用找到结果。 |
Add Error |
无法添加项目。 |
Remvoe Error |
无法除去项目。 |
Update Error |
无法更新项目。 |
与内容服务有关的错误包括:
除了万维网服务API之外,服务特有API也可以用于向特定服务提供最佳接口能力。下面描述若干示范性服务特有API。
Service Alpha是支持Mac和PC计算机和iPad设备的基于浏览器应用程序。
Service Alpha服务的“内容获得”方法跟踪通过名称指定的元数据,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
Track |
是 |
|
name |
track name |
是 |
渠道名称。 |
Service Alpha服务的“内容获得”方法跟踪通过id指定的元数据,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
Track |
是 |
|
id |
track id |
是 |
渠道id。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“内容获得渠道”方法获取所有渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
track |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“内容获得相册渠道”方法获取通过相册名称指定的渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
track |
是 |
|
content type |
album |
是 |
|
context name |
album name |
是 |
相册名称。 |
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“内容获得艺术家渠道”方法获取通过艺术家姓名指定的渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
track |
是 |
|
context type |
artist |
是 |
|
context name |
artist name |
是 |
艺术家姓名。 |
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“内容风格渠道”方法列出通过风格名称指定的渠道,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
track |
是 |
|
context type |
genre |
是 |
|
context name |
genre name |
是 |
风格名称。 |
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得相册”方法获取通过名称指定的相册元数据,以及相关参数包括:
service |
Service Alpha |
是 |
内容服务名称。 |
type |
album |
是 |
|
name |
album name |
是 |
相册名称。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得相册渠道id”方法获取通过渠道id指定的相册元数据,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
Album |
是 |
|
context type |
Track |
是 |
|
cid |
track id |
是 |
渠道id。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得相册渠道名称”方法获取通过渠道名称指定的相册的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
Album |
是 |
|
context type |
Track |
是 |
|
context name |
track name |
是 |
渠道名称。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得艺术家相册”方法获取通过艺术家姓名指定的相册的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
album |
是 |
|
context type |
artist |
是 |
|
context name |
artist name |
是 |
艺术家姓名。 |
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得风格相册”方法获取通过风格名称指定的相册的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
album |
是 |
|
context type |
genre |
是 |
|
context name |
genre name |
是 |
风格名称。 |
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得艺术家”方法获取艺术家的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
artist |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
Service Alpha服务的“获得风格”方法获取所有风格的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Alpha |
是 |
内容服务名称。 |
type |
genre |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
除了这些示范性方法之外,通过应用本文所述的用户API116方法、内容API104方法、反馈API106方法、更新API108方法和设备API110方法也可以或可替代地使用其它适当方法。
Service Beta方法包括“添加Service Beta服务”方法,其使用服务用户名和服务密码参数添加现有帐户或匿名帐户,并返回更新的用户服务列表。HTTP方法是POST,需要https,以及相关参数包括:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
oauth |
是 |
这个参数应该设置成1。 |
service username |
否 |
用户的服务用户名。 |
service password |
否 |
用户的服务密码。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
Service Beta“获得有特色艺术家”方法获取有特色艺术家的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Beta |
是 |
内容服务名称。 |
type |
artist |
是 |
|
filter |
featured |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
sig |
call sig |
是 |
调用签名。 |
Service Beta“获得艺术家站点渠道”方法获取通过艺术家指定的站点渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Beta |
是 |
内容服务名称。 |
type |
track |
是 |
|
context type |
artist |
是 |
|
cid |
artist id |
是 |
艺术家id。 |
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
sig |
call sig |
是 |
调用签名。 |
Service Beta“获得当前用户站点渠道”方法像在用户站点播放主要从喜欢的渠道和艺术家以及其它个人数据中选择的类似渠道的情况下那样、获取通过用户指定的站点渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Beta |
是 |
内容服务名称。 |
type |
track |
是 |
|
context type |
user |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
sig |
call sig |
是 |
调用签名。 |
Service Beta“获得个人站点渠道”方法像在个人站点是几乎全部由用户喜欢渠道组成的站点的情况下那样、获取通过用户指定的个人站点渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Beta |
是 |
内容服务名称。 |
type |
track |
是 |
|
context type |
user |
是 |
|
cid |
user id |
是 |
用户id。 |
filter |
favorite |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
sig |
call sig |
是 |
调用签名。 |
Service Beta“获得精选站点渠道”方法像在精选站点包含所选渠道的情况下那样、获取通过站点指定的精选站点渠道的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Beta |
是 |
内容服务名称。 |
type |
track |
是 |
|
context type |
station |
是 |
|
cid |
station id |
是 |
精选站点id。 |
filter |
picks |
是 |
|
start |
|
否 |
开始索引。 |
count |
|
否 |
从开始索引开始返回的项目的数量。 |
key |
partner key |
是 |
伙伴密钥。 |
sig |
call sig |
是 |
调用签名。 |
除了这些示范性方法之外,通过应用本文所述和上面针对其它服务所示的用户API116方法、内容API104方法、反馈API106方法、更新API108方法和设备API110方法也可以或可替代地使用其它适当方法。
Service Prime内容API方法包括添加Service Prime服务的“添加Service Prime服务”方法。一旦成功,就将更新的用户服务列表返给用户。否则,返回适当错误。HTTP方法是POST,需要https,以及相关参数包括:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
service username |
是 |
用户的服务用户名。 |
service password |
是 |
用户的服务密码。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
“Service Prime获得站点”方法获得站点元数据,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Prime |
是 |
内容服务名称。 |
type |
station |
是 |
|
id |
station id |
是 |
站点id。 |
key |
partner key |
是 |
伙伴密钥。 |
sig |
call sig |
是 |
这种调用的签名。 |
除了这些示范性方法之外,通过应用本文所述和上面针对其它服务所示的用户API116方法、内容API104方法、反馈API106方法、更新API108方法和设备API110方法也可以或可替代地使用其它适当方法。
Service Gamma内容API方法包括添加Service Gamma服务的“添加Service Gamma服务”方法。一旦成功,就返还URL。否则,返回适当错误。HTTP方法是POST,需要https,以及相关参数包括:
service |
是 |
要添加的服务。 |
oauth |
是 |
这个参数应该设置成1。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
“Service Gamma获得艺术家”方法通过id获取艺术家的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Gamma |
是 |
内容服务名称。 |
type |
artist |
是 |
|
id |
sartist id |
是 |
艺术家id。 |
key |
partner key |
是 |
伙伴密钥。 |
除了这些示范性方法之外,通过应用本文所述和上面针对其它服务所示的用户API116方法、内容API104方法、反馈API106方法、更新API108方法和设备API110方法也可以或可替代地使用其它适当方法。
Service Delta内容API方法包括用于添加Service Delta服务的“添加ServiceDelta服务”方法。一旦成功,就将更新的用户服务列表返给用户。否则,返回适当错误。HTTP方法是POST,需要https,以及相关参数包括:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
service username |
是 |
用户的服务用户名。 |
service password |
是 |
用户的服务密码。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
Service Delta“通过id获得艺术家”方法获取通过id指定的艺术家元数据,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Delta |
是 |
内容服务名称。 |
type |
artist |
是 |
|
id |
artist id |
是 |
艺术家id。 |
key |
partner key |
是 |
伙伴密钥。 |
除了这些示范性方法之外,通过应用本文所述和上面针对其它服务所示的用户API116方法、内容API104方法、反馈API106方法、更新API108方法和设备API110方法也可以或可替代地使用其它适当方法。
Service Sigma内容API包括“添加Service Sigma服务”方法。一旦成功,就将更新的用户服务列表返给用户。否则,返回适当错误。HTTP方法是POST,需要https,以及相关参数包括:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
service username |
是 |
用户的服务用户名。 |
service password |
是 |
用户的服务密码。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
Service Sigma“获得艺术家”方法获取带有相册的列表的艺术家元数据,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Sigma |
是 |
内容服务名称。 |
type |
artist |
是 |
|
id |
artist id |
是 |
艺术家id。 |
key |
partner key |
是 |
伙伴密钥。 |
除了这些示范性方法之外,通过应用本文所述和上面针对其它服务所示的用户API116方法、内容API104方法、反馈API106方法、更新API108方法和设备API110方法也可以或可替代地使用其它适当方法。
Service Tau内容API方法包括添加Service Tau服务的“添加Service Tau服务”方法。一旦成功,就将更新的用户服务列表返给用户。否则,返回适当错误。HTTP方法是POST,需要https,以及相关参数包括:
名称 |
需要 |
说明 |
service |
是 |
要添加的服务。 |
service username |
是 |
用户的服务用户名。 |
service password |
是 |
用户的服务密码。 |
key |
是 |
伙伴密钥。 |
sig |
是 |
这种调用的签名。 |
Service Tau“获得根链接”方法用于生成用户界面前端。它返回以后可以用于其它方法向下浏览树状检索链路、站点和节目的链接的列表,以及相关参数包括:
参数 |
值 |
需要 |
说明 |
service |
Service Tau |
是 |
内容服务名称。 |
type |
link |
是 |
|
machine id |
machine id |
否 |
机器id。 |
key |
partner key |
是 |
伙伴密钥。 |
应该强调的是,上述实施例仅仅是可能实现的例子。可以不偏离本公开的原理地对上述实施例作出许多改变和修改。所有这样的修改和改变都要包括在本公开的范围之内以及受所附权利要求书保护。