天翼互联平台开发者指南(第三方)

《天翼互联平台开发者指南(第三方)》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、天翼互联平台开发者指南天翼互联平台开发者指南V1.0综合平台开发运营中心2013年12月-19-天翼互联平台开发者指南目录总则-3-1.1名词术语-3-2.天翼互联平台介绍-4-3.天翼登录开发流程-5-4.天翼登录OAuth2.0授权机制-9-4.1OAuth2.0简介-9-4.2OAuth2.0开发文档-11-5.API能力接口-20-5.1API能力列表-20-5.2SDK开发包-21--19-天翼互联平台开发者指南总则1.1名词术语名称描述天翼帐号天翼帐号以手机号、邮箱和用户作为用户登录网站或移动应用及享受各项服务的统一认证鉴权标识凭证。

2、天翼帐号客户端天翼帐号客户端，主要包括便捷设置天翼帐号，“一号通行“移动应用，个人数据同步与备份，用户个性设置及用户消息通知、天翼帐号能力开放授权等AppID申请“天翼登录”成功后，分配给网站或移动用户的appid，用来唯一标识网站或移动应用appSecret申请“天翼登录”成功后，分配给网站的appSecret。appSecret将在“天翼登录”过程中以及网站或移动应用通过API访问/修改受保护的资源时，用来计算签名值，以提高传输过程参数的防篡改性。OpenIDOpenID是网站或移动应用中唯一对应用户身份的标识。根据APPID以及天翼帐号生成

3、（生成规则为按手机号码>邮箱>用户的高低顺利，如用户有绑定手机号码，即拿appid与手机号码生成），不同的appid下同一个天翼帐号生成的OpenID是不一样的（目前不接受同一个开发者名下的不同应用之间对于同一个用户的OpenID的互通）。天翼帐号的手机号码、邮箱和用户名默认不对外开放，有特殊需要手工设置开放-19-天翼互联平台开发者指南1.天翼互联平台介绍1.1.1平台介绍天翼互联平台为第三方网站（WEB/WAP）或移动应用提供了电信及合作伙伴丰富的能力服务API接口。第三方网站或移动应用接入天翼互联平台后，即可通过调用平台提供的API接口实现

4、用户使用天翼账号登录网站或移动应用功能，且可以获取到天翼帐号的相关信息。第三方合作方接入天翼互联平台后，您将获得：n海量新用户：用户使用已有的天翼帐号即可登录网站或移动应用，天翼套件一键登录更可减少登录交互操作，大大降低网站或移动应用注册门槛，给网站或移动应用带来海量新用户。n丰富的特权服务：首次成功登录的用户可免费获的电信手机上网流量、WIFI时长、短信和通话时长等志属特权服务，每月活跃次数达到一定次数可持续性获得赠送。n丰富的开放API：网站或移动应用通过调用天翼互联平台提供的丰富API接口实现用户信息、电信套餐信息、发免费短信、支付、云空间

5、、189邮箱和云通讯录等功能。1.1.2目标客户所有的互联网网站和移动应用1.1.3接入方式天翼互联平台为网站和移动应用提供了丰富便捷的SDK集成包，辅助开发者快速接入天翼登录和API能力调用等功能nAPI接入方式网站和移动应用均可使用n网站接入SDK-19-天翼互联平台开发者指南提供JAVA-SDK、PHP-SDK和.NET-SDK等主流开发语言开发集成包n移动应用接入SDK提供Android-SDK、IOS-SDK和WP7等主流手机平台开发集成包1.天翼登录开发流程1.1开发者注册开发者通过天翼互联平台门户以天翼帐号进行登录后，在注册页面提交

6、公司或个人基本资料后。重要提示：开发者天翼帐号一旦注册不能变更，建议使用公司公共天翼帐号而不是员工私人号码注册，以免遇到员工离职等情况造成不必要的麻烦。1.1.1.1接入申请网站或移动应用接入前，需首先创建网站或移动应用，并获得对应的appid与appSecret，以保证后续流程中可正确对网站或移动应用与天翼帐户进行验证与授权。1.1.1.2开发流程概述对网站或移动应用进行开发，即完成天翼登录功能并正常放置天翼登录按钮，具体开发流程主要包括如下几个步骤：1.1.1.2.1设置天翼登录入口网站或移动应用开发者可以在自己的网站或移动应用首页入口和主要

7、的登录、注册页面上放置“天翼登录”标识（见红色方框标记处）：-19-天翼互联平台开发者指南网站登录标识移动应用登录标识1.1.1.1.1用户登录验证和授权1）用户点击按钮之后弹出天翼登录的窗口，在登录窗口中将显示网站或移动应用相关标识信息，如名称以及链接地址等。如果用户已登录“天翼帐号客户端”或其它已接入天翼互联平台的网站或移动应用，也可以一键快速登录。2）登录界面右边为用户选择授权允许网站或移动应用访问自己的相关信息（仅在第一次成功登录，以及第一次访问某个未授权的API时会出现授权页），如下图所示： -19-天翼互联平台开发者指南网站登录界面W

8、AP登录界面移动应用登录界面授权框中的授权列表由第三方网站或移动应用自行配置，详见scope参数说明。建议控制授权项的数量，只传入必要的