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