无线音乐能力开放平台-企业级服务器接口规范15

《无线音乐能力开放平台-企业级服务器接口规范15》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、无线音乐能力开放平台企业级服务器接口规范（1.5.7）1.前言本文档的目的是描述无线音乐开放能力平台和紧密合作伙伴服务器之间的通讯接口规范，是采用服务器对接中国移动无线音乐开放能力平台必须遵循的接口规范。本规范主要包括以下几方面内容：接口通信机制、接口描述和接口定义。1.1.引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范

2、。表1-1引用文件列表序号标准编号标准名称发布单位[1]QB-xx-xx-xx音乐开放平台接口规范中国移动无线音乐基地[2]1.2.术语、定义和缩略语1.2.1.术语、定义下列术语、定义和缩略语适用于本规范：本文中关键字“MUST”、“MUSTNOT”、“REQUIRED”、“SHALL”、“SHALLNOT”、“SHOULD”、“SHOULDNOT”、“RECOMMENDED”、“MAY”与“OPTIONAL”的解释见[RFC2119]。除“范围”与“介绍”以外的所有章节与附录均是规范内容，除非特别声明为非规范。表1-2术语/定

3、义术语/定义解释能力能力是供应用使用的基础组件和API，如用户登录、订购彩铃等。能力产品针对各类能力，进行定价之后，即形成能力产品。应用开发者在音乐开放平台注册，经中国移动审核通过，可以使用音乐开放平台所开放的各种能力和配套资源进行应用的开发和运营的第三方的个人或企业，需要接受中国移动音乐开放平台的管理，以下简称开发者。应用由应用开发者根据自己的创意使用音乐开放平台提供的各种能力产品进行开发后，为中国移动的用户提供服务的相关的业务逻辑的具体实现。应用产品针对各类应用，进行定价之后，即形成应用产品。APPID唯一标识应用的字符串，由

4、系统自动生成。APPKEY用于验证应用合法的随机字符串，由系统自动生成。1.1.1.缩略语表1-3缩略语缩略语英文全称中文含义DEVApplicationDeveloper应用开发者APPApplication应用APPPApplicationProduct应用产品EAEnabler能力EAPEnablerProduct能力产品EPEnablerProvider能力提供者2.系统结构无线音乐能力开放平台与合作伙伴服务器之间调用关系如下图1-1所示，对于不同的合作伙伴，手机端到其自己的服务器采用的接口由合作伙伴自己定义和实现（如图中

5、IF1和IF2所示），不是本规范的定义范围。本协议规范只定义从合作伙伴服务器到无线音乐开放能力平台服务器之间的接口规范，即图1-1中的IF0所标识的接口。图1-1无线音乐能力开放平台接口调用关系从终端应用到合作伙伴服务器以及能力开放平台之间的接口调用关系时序图如图1-2所示。图1-2接口调用时序图1.接口说明1.1.接口通讯机制合作伙伴接口服务器与无线音乐开放平台接口服务器采用HTTP+XML报文方式进行接口调用。无线音乐开放平台轻量方案接口服务器的IP地址：218.200.230.142，端口：85。serverRoot=218

6、.200.230.142:85/opServerapiVersion=1.0举例：用户管理类—获取用户信息地址为：http://218.200.230.142:85/opServer/1.0/user/query，所有接口列表详见3.3.11.2.接口说明1.2.1.接口概述接口调用采用标准的HTTP协议，接口参数将分成两部分，公共部分和接口私有部分。公共部分是对于每个接口都具备的部分，将通过HTTP协议的authorization字段承载。【参考RFC1945关于HTTP协议字段说明】接口私有部分是对具体接口参数的详细描述，采用

7、的是标准XML格式。3.2.1.1.HTTP头部HTTP头字段字段值属性名可选属性值描述AuthorizationOEPAUTH否表示认证方式为OpenEnablerPlantformAUTH。IMSI否经过MD5数字指纹后的IMSI串。appID否在开发者门户上，申请创建应用时获得AppID。pubKey否应用签名公钥串的MD5数字指纹串。netMode否网络接入模式的字符串取值为：WIFIWIFI网络接入CMWAPCMWAP网络接入CMNETCMNET网络接入OTHER其他接入方式packageName否SDK自动获取的应用包

8、名version否SDK版本号（目前设置为“S1.0”）excode是合作伙伴自分配编码（四位，默认0000）18位字符串definedseq是合作伙伴自定义流水号消息示例：（注意Authorization中不要有多余的空格和回车符）POSThtt