联通WO+开放平台开发者指南Word格式.docx
《联通WO+开放平台开发者指南Word格式.docx》由会员分享，可在线阅读，更多相关《联通WO+开放平台开发者指南Word格式.docx（49页珍藏版）》请在冰豆网上搜索。
按钮，提示购置成功。
我的>
我的App〞。
选择应用类型，单击
或
按钮创立应用，如下所示。
选择App类型
支持Web效劳端应用和手机客户端应用接入WO+能力共享平台。
请根据您的应用类型选择。
如果您尚未购置任何API包，会弹出如下提示框，请返回API商城购置API包，具体请见步骤2、3、4。
填写应用信息。
例如，创立手机客户端应用界面如下所示。
创立App
关联已购置的API包，如下所示。
勾选需要的API包，单击“确定〞按钮。
应用必须与您已购置的API包关联，关联前方可调用API包中的接口。
关联已购置的API包
联通WO+开放平台开发者指南〔3〕—如何开发和调试应用
您可以在资源工具区查看API文档，也可以下载开发工具SDK，您可以根据API文档开发接口。
SDK开发包下载：
提供SDK下载开发工具SDK，助您快速掌握调用API方法，降低开发门槛。
API文档说明：
目前提供多种接口说明，以后会逐步添加更多API供开发者调用。
同时也可以申请高级API，局部高级API需要联系后台管理员为您开通。
测试工具下载：
提供测试工具可供开发者开发调试时下载、测试第三方资源下载。
联通WO+开放平台开发者指南〔4〕—接口消息格式
WO+能力共享平台开放的所有API均遵循REST协议风格。
该协议的定义基于传输协议，使用标准的方法〔GET、POST、PUT和DELETE〕检索和改变效劳器状态。
REST请求
REST请求的格式如下：
Request=
-MethodRequest-URI<
anyvalidversionidentifier>
["
Authorization:
"
AuthorizationParameter]
Content-Type:
Content-Type]
Accept:
Accept]
[*（<
一个有效的消息头，可以不止上面举例的参数>
]
[REST-Request-Payload]
REST请求消息中的元素说明如下所示。
表1
REST请求消息元素说明
元素
说明
-Method
请求方法。
在REST的请求中可能使用请求方法为：
-Method="
GET"
/"
POST"
PUT"
DELETE"
其中，“GET〞表示检索资源〔也叫获取资源〕，“POST〞表示创立资源，“PUT〞表示更新资源〔也叫修改资源〕，“DELETE〞表示删除资源。
Request-URI
请求目标地址。
Authorization
接口认证请求参数。
Content-Type
消息体内容格式类型。
Accept
期望返回的响应消息体内容格式类型。
REST响应
REST响应的格式如下：
/1.1-Status-Code
resultCode:
resultCode]
resultDescription:
resultDescription]
REST响应消息中的元素说明如下所示。
表2
REST响应消息元素说明
-Status-Code
状态码。
消息体格式说明。
resultCode
结果码。
resultDescription
结果描述。
联通WO+开放平台开发者指南〔5〕—接口平安
为了WO+能力共享平台接口调用的平安性，大多数接口调用采用S协议。
对于S的实现算法要求为：
非对称加密采用RSA算法，采用1024bits长的密钥。
对称加密算法支持主流的RC4〔128bits〕、AES〔128bits〕、DES〔56bits〕、3DES〔168bits〕。
联通WO+开放平台开发者指南〔6〕—通用消息头元素
接口认证分为token认证和开发者身份认证。
当接口认证为token认证时，请求参数格式如下：
appKey="
appKey值"
token="
token值"
authCode="
authCode值"
∙应用需要用户授权的API时，携带authCode字段。
∙应用无需用户授权的API时，无需携带authCode字段。
当接口认证为开发者身份认证时，请求参数格式如下：
platformID="
platformID值"
password="
password值"
∙platformID：
首页-用户信息-开发者信息中的用户ID。
∙password：
首页-用户信息-开发者信息中的调用密码。
请求或者响应中用来鉴定内容类型的字符串。
格式如下：
application/json或text/xml;
charset=UTF-8
在请求消息中，需要在“Accept〞头中指定期望的响应消息类型。
application/json或text/xml
∙如果请求消息中未指定，那么响应消息与请求消息类型尽量保持一致。
∙如果效劳端不能支持所请求的消息类型，那么返回406错误。
联通WO+开放平台开发者指南〔7〕—平台结果码
通用结果码
结果码
请求成功。
1
开放平台系统内部错误。
2
token错误。
3
authCode错误或无authCode。
4
authCode过期。
5
账户错误。
6
XX余额缺乏或信用度不够。
7
SLA鉴权失败。
8
未签约该能力。
9
必选参数缺失。
10
非测试用户。
11
appKey错误。
12
效劳器忙而无法处理请求。
13
网络忙而无法处理请求。
14
sessionID无效。
15
请求中参数的格式不对。
16
开发者状态不正常。
17
应用状态不正常。
18
OpenAPI状态不正常。
19
黑用户不可达。
20
其他错误。
61
appKey/platformId或secret错误。
62
appKey和redirectURL不匹配。
63
用户未同意授权应用。
64
refreshAuthCode已经过期。
65
appKey和refreshAuthCode不匹配。
66
开发者id或password错误。
1001
发起方或接收方的错误。
1002
无效scope。
1003
appSecret错误。
1004
用户未同意授权。
1005
refreshAuthCode错误。
1006
refreshAuthCode过期。
1010
必选参数为空。
1012
摘要类型错误。
1013
IP校验失败。
认证授权
认证授权接口结果码
短信
表3
短信接口结果码
21
发送目的地址超出最大值。
22
短信内容超出最大值。
23
短信内容中包含敏感词。
24
发送错误。
46
短信/彩信目的地址为空。
48
notifyURL格式错误。
彩信
表4
彩信接口结果码
42
43
彩信内容超出最大值。
44
彩信内容中包含敏感词。
45
彩信附件包括了不支持的附件类型。
47
彩信Subject长度超过70个字节。
定位效劳
表5
定位效劳接口结果码
101
发起定位的用户未知。
102
定位用户未知。
103
暂不允许定位他人。
104
用户目前不可到达。
105
因暂时性位置方法问题，位置效劳器无法确定MS的位置。
106
请求应用不在MS的私人列表中。
107
对用户定位时移动网络忙。
108
对用户定位时位置效劳器忙。
109
MS不支持被请求的位置方法。
110
无法获得在效劳质量中说明的被请求时间要求。
111
根底网络中出现故障。
112
用户余额缺乏。
113
用户欠费。
114
移动台挂失。
115
应用在用户列表中完全拒绝。
116
应用该时间段不允许。
117
主叫用户密码错。
118
主叫用户该时间段不允许。
121
系统错误（系统内部出错）。
122
被查手机在ICP的配置中制止被查手机在行业ICP的黑。
123
等待用户回应超时〔查询需要用户确认时，用户超时，未返回应答〕。
124
用户确认为拒绝查询〔查询需要用户确认时，用户返回拒绝〕。
125
用户不在效劳区内（手机无信号）。
126
不支持的效劳。
127
制止定位（用户查询的隐私鉴权未通过，在被查用户的黑或者被查用户制止查询）。
128
位置效劳器无法计算位置（用户所在CELLID在系统基站数据中查不出来）。
129
请求定位平台错误。
130
用户手机关机。
131
定位激活失败。
132
获取用户所在城市信息失败。
135
LSP平台主动停顿触发定位请求。
136
定位结果超时。
137
元素值不合法。
138
未知错误。
假设发生的错误超出本列表的X围，那么使用该错误码。
如果用户隐私相关，不得通知业务平台具体的错误码，可用此错误码。
139
UNSUPPORTEDVERSION。
140
不支持的效劳〔service〕。
LSP不支持该效劳。
141
元素属性不支持。
LSP不支持元素属性。
142
元素属性值不合法。
升级会员 