《联通WO+开放平台开发者指南》由会员分享，可在线阅读，更多相关《联通WO+开放平台开发者指南（50页珍藏版）》请在金锄头文库上搜索。
1、联通 WO+开放平台开发者指南（1）如何成为开发者图 1 申请成为开发者流程 详细操作步骤如下。1. 访问 WO+能力共享平台，网址“http:/”。2. 单击页面右上角 注册账号。注册页面如 图 2 所示。图 2 注册 3. 单击“注册”提交注册申请。提交成功后，页面提示信息如 图 3 所示。图 3 注册成功 4. 登录邮箱激活账号。激活邮件示意如 图 4 所示。图 4 激活账号 单击邮件中的激活链接后，跳转至 WO+能力共享平台，页面如 图 5 所示。图 5 激活成功 联通 WO+开放平台开发者指南（2）如何接入应用通过简单的几个步骤，即可将您的应用上线发布到 WO+能力共享平台上。访问
2、WO+能力共享平台，网址为“http:/” 。使用开发者账号登录。选择“开发者 商城” ，进入 API 包商城。选择自己需要的 API 包，单击其图标进入 API 包详情。若需要购买 API 包，请单击 按钮，弹出购买确认框，如下所示。单击 按钮，提示购买成功。选择“开发者 我的 我的 App”。选择应用类型，单击 或 按钮创建应用，如下所示。图 1 选择 App 类型 支持 Web 服务端应用和手机客户端应用接入 WO+能力共享平台。请根据您的应用类型选择。如果您尚未购买任何 API 包，会弹出如下提示框，请返回 API 商城购买 API 包，具体请见步骤 2、3、4。填写应用信息。例如，创
3、建手机客户端应用界面如下所示。图 2 创建 App 关联已购买的 API 包，如下所示。勾选需要的 API 包，单击“确定”按钮。应用必须与您已购买的 API 包关联，关联后方可调用 API 包中的接口。图 3 关联已购买的 API 包 联通 WO+开放平台开发者指南（3）如何开发和调试应用您可以在资源工具区查看 API 文档，也可以下载开发工具 SDK，您可以根据 API 文档开发接口。SDK 开发包下载：提供 SDK 下载开发工具 SDK，助您快速掌握调用 API 方法，降低开发门槛。API 文档说明：目前提供多种接口说明，以后会逐步添加更多 API 供开发者调用。同时也可以申请高级API
4、，部分高级 API 需要联系后台管理员为您开通。测试工具下载：提供测试工具可供开发者开发调试时下载、测试第三方资源下载。联通 WO+开放平台开发者指南（4）接口消息格式WO+能力共享平台开放的所有 API 均遵循 REST 协议风格。该协议的定义基于 HTTP 传输协议，使用标准的 HTTP 方法（GET、POST、PUT 和 DELETE）检索和改变服务器状态。REST 请求REST 请求的格式如下：Request =HTTP-Method Request-URI Authorization: Authorization ParameterContent-Type: Content-Type
5、Accept: Accept*(REST-Request-PayloadREST 请求消息中的元素说明如下所示。表 1 REST 请求消息元素说明元素 说明HTTP-MethodHTTP 请求方法。在 REST 的请求中可能使用 HTTP 请求方法为：HTTP-Method = GET/POST/PUT/DELETE其中，“GET”表示检索资源（也叫获取资源），“POST”表示创建资源，“PUT”表示更新资源（也叫修改资源），“DELETE”表示删除资源。Request-URI HTTP 请求目标地址。Authorization 接口认证请求参数。Content-Type 消息体内容格式类型。
6、Accept 期望返回的响应消息体内容格式类型。REST 响应REST 响应的格式如下：HTTP/1.1 HTTP-Status-CodeContent-Type: Content-TyperesultCode: resultCoderesultDescription: resultDescriptionREST 响应消息中的元素说明如下所示。表 2 REST 响应消息元素说明元素 说明HTTP-Status-Code HTTP 状态码。Content-Type 消息体格式说明。resultCode 结果码。resultDescription 结果描述。联通 WO+开放平台开发者指南（5）接口
7、安全为了 WO+能力共享平台接口调用的安全性，大多数接口调用采用 HTTPS 协议。对于 HTTPS 的实现算法要求为：非对称加密采用 RSA 算法，采用 1024bits 长的密钥。对称加密算法支持主流的 RC4（128bits） 、AES（128bits） 、DES（56bits） 、3DES（168bits） 。联通 WO+开放平台开发者指南（6）通用消息头元素Authorization接口认证分为 token 认证和开发者身份认证。当接口认证为 token 认证时，请求参数格式如下：Authorization: appKey=appKey 值,token=token 值,authCod
8、e=authCode 值 应用访问需要用户授权的 API 时，携带 authCode 字段。 应用访问无需用户授权的 API 时，无需携带 authCode 字段。当接口认证为开发者身份认证时，请求参数格式如下：Authorization: platformID=platformID 值,password=password 值 platformID：首页-用户信息-开发者信息中的用户 ID。 password：首页-用户信息-开发者信息中的调用密码。Content-Type请求或者响应中用来鉴定内容类型的字符串。格式如下：Content-Type: application/json 或 tex
9、t/xml;charset=UTF-8Accept在请求消息中，需要在 HTTP“Accept”头中指定期望的响应消息类型。格式如下：Accept: application/json 或 text/xml 如果请求消息中未指定，则响应消息与请求消息类型尽量保持一致。 如果服务端不能支持所请求的消息类型，则返回 HTTP 406 错误。联通 WO+开放平台开发者指南（7）平台结果码通用结果码表 1 通用结果码结果码 说明0 请求成功。1 开放平台系统内部错误。2 token 错误。3 authCode 错误或无 authCode。4 authCode 过期。5 账户错误。6 帐户余额不足或信用度
10、不够。7 SLA 鉴权失败。8 未签约该能力。9 必选参数缺失。10 非测试用户。11 appKey 错误。12 服务器忙而无法处理请求。13 网络忙而无法处理请求。表 1 通用结果码结果码 说明14 sessionID 无效。15 请求中参数的格式不对。16 开发者状态不正常。17 应用状态不正常。18 OpenAPI 状态不正常。19 黑名单用户不可达。20 其他错误。61 appKey/platformId 或 secret 错误。62 appKey 和 redirectURL 不匹配。63 用户未同意授权应用。64 refreshAuthCode 已经过期。65 appKey 和 re
11、freshAuthCode 不匹配。66 开发者 id 或 password 错误。1001 发起方或接收方的号码错误。1002 无效 scope。1003 appSecret 错误。1004 用户未同意授权。表 1 通用结果码结果码 说明1005 refreshAuthCode 错误。1006 refreshAuthCode 过期。1010 必选参数为空。1012 摘要类型错误。1013 IP 校验失败。认证授权表 2 认证授权接口结果码结果码 说明0 请求成功。61 appKey/platformId 或 secret 错误。62 appKey 和 redirectURL 不匹配。63 用
12、户未同意授权应用。64 refreshAuthCode 已经过期。65 appKey 和 refreshAuthCode 不匹配。短信表 3 短信接口结果码结果码 说明21 发送目的地址超出最大值。22 短信内容超出最大值。23 短信内容中包含敏感词。表 3 短信接口结果码结果码 说明24 发送号码错误。46 短信/彩信目的地址为空。48 notifyURL 格式错误。彩信表 4 彩信接口结果码结果码 说明24 发送号码错误。42 发送目的地址超出最大值。43 彩信内容超出最大值。44 彩信内容中包含敏感词。45 彩信附件包括了不支持的附件类型。46 短信/彩信目的地址为空。47 彩信 Sub
13、ject 长度超过 70 个字节。48 notifyURL 格式错误。定位服务表 5 定位服务接口结果码结果码 说明101 发起定位的用户未知。102 定位用户未知。103 暂不允许定位他人。104 用户目前不可到达。表 5 定位服务接口结果码结果码 说明105 因暂时性位置方法问题，位置服务器无法确定 MS 的位置。106 请求应用不在 MS 的私人列表中。107 对用户定位时移动网络忙。108 对用户定位时位置服务器忙。109 MS 不支持被请求的位置方法。110 无法获得在服务质量中说明的被请求时间要求。111 基础网络中出现故障。112 用户余额不足。113 用户欠费。114 移动台挂
14、失。115 应用在用户列表中完全拒绝。116 应用该时间段不允许。117 主叫用户密码错。118 主叫用户该时间段不允许。121 系统错误(系统内部出错)。122 被查手机在 ICP 的配置中禁止被查手机在行业 ICP 的黑名单。123 等待用户回应超时（查询需要用户确认时，用户超时，未返回应答）。124 用户确认为拒绝查询（查询需要用户确认时，用户返回拒绝）。表 5 定位服务接口结果码结果码 说明125 用户不在服务区内(手机无信号)。126 不支持的服务。127禁止定位(用户查询的隐私鉴权未通过，在被查用户的黑名单或者被查用户禁止查询)。128 位置服务器无法计算位置(用户所在 CELLI
15、D 在系统基站数据中查不出来)。129 请求定位平台错误。130 用户手机关机。131 定位激活失败。132 获取用户所在城市信息失败。135 LSP 平台主动停止触发定位请求。136 定位结果超时。137 元素值不合法。138未知错误。若发生的错误超出本列表的范围，则使用该错误码。如果用户隐私相关，不得通知业务平台具体的错误码，可用此错误码。139 UNSUPPORTED VERSION。140 不支持的服务（service）。LSP 不支持该服务。141 元素属性不支持。LSP 不支持元素属性。142 元素属性值不合法。表 5 定位服务接口结果码结果码 说明143 元素值不支持。该值在规范
16、定义中合法，但 LSP 实现中不支持该元素值。145 请求的触发定位服务已终止。146 请求 QoP 不支持。147 由于用户隐私设置或者 WO+能力共享平台隐私设置，用户不允许被定位。148 出于法律原因，该定位不允许。149 LSP 忙。由于 LSP 负荷满，拒绝接收新的定位请求。150业务平台不支持标准定位报告服务（standard location report service）。151 应用发生错误。152 应用不接收标准定位报告请求。157 不支持查询所要求的定位精度(ll_acc/hor_acc/alt_acc 不支持)。158 不支持查询所要求的响应时间。160 TLRSR 中取消的 REQID 不存。161 不支持的定位类型
