移动应用接入

移动应用接入简介

第三方移动应用客户端与开心网连接,能够让用户直接用开心网账号登录您的移动应用,并可将您移动客户端的精彩内容分享到开心网,通过用户好友关系广泛传播开来。

开心网开放平台为移动应用程序连接开心网提供了Android和iOS系统的SDK,对于其它移动应用和WAP移动网站也可以通过支持Mobile Web的OAuth验证授权方式登录开心网。

接入流程

1. 创建应用

如果您是第一次创建应用,需要首先注册为开发者;填写开发者信息,并成功验证邮箱后即注册为开心网开放平台的开发者。开心网通过您留下的手机号码、邮箱等与您联系,请务必如实填写。如信息填写有误,可能造成应用审核延迟或无法通过。如果在注册开发者过程中有问题,请参考注册开发者详细说明或咨询在线产品支持

注册为开发者后,您就可以创建应用了。请进入开放平台我的应用页面,点击右上方的“创建新应用”按钮,选择“客户端”类型,填写应用名称并同意开发者协议即完成应用创建。

1) 点击“创建新应用”按钮

2) 选择“客户端”类型

3)填写应用名称完成创建

2. 编辑应用信息

2.1 应用基本信息

基本信息每项均为必填,填写完毕务必点击“保存”按钮。

2.2 应用地址

1) 应用介绍页:应用介绍页面的地址
2) iOS/Android/桌面应用/其他客户端应用:请应用根据自身情况选择相应的应用类型,并填写“下载地址”,方便用户下载你的应用
注:如果没有应用介绍地址和下载地址,可以先提交开心网审核,应用正式发布后再进行修改.

2.3 应用图标

应用图标用于应用中心列表页、个人页面应用菜单、动态流等处,务必按照要求上传相应格式、大小的图片资源。

注意:由于图标多放在有背景色的页面中,因此图标底色需设置为透明或非白色的其他颜色,这样才能与开心网的整体页面风格协调起来;
请开发者务必按照要求的格式、大小提供相应的图标和截图;图标不合格会影响应用的审核、上线。

3. 功能开发

应用创建完毕后即可获取APP ID/API Key/Secret Key,同时您就获得了OAuth等开放API的调用权限。

3.1 应用授权

开心连接目前采用OAuth协议,开发时请参考:OAuth1.0a文档OAuth2.0文档xAuthAPI2.0文档API2.0调用示例接口访问权限说明

另外,开心网还提供了各种语言版本的SDK供你下载参考,立即下载SDK

3.2 登录流程

普通登录授权

将用户的浏览器重定向到URL:
例如: http://api.kaixin001.com/oauth/authorize?oauth_token=55cb58c6627c7965d0abda075fa74a&oauth_callback=http%3A%2F%2Fwww.yoururl.com%2Fcallback.php&oauth_client=1

说明:

①callback=http%3A%2F%2Fwww.yoururl.com%2Fcallback.php回调页面地址,oauth_client=1标识
 跳转到手机版的参数,通过UA判断跳转到不同的版本。
②callback的URL必需做UrlEncode处理。

普通登录授权界面如下:
 

适用于智能手机的登录授权

通过UA判断,若为android和iphone手机则会跳转到如下界面:
登录页:

授权页:

3.3 Android系统的移动应用接入

创建“客户端”应用后,使用开心网开放平台官方封装的开源Android SDK(基于OAuth1.0a) 立即下载>>

Android SDK是一个开源的JAVA库,通过这个库,你可以登录到开心网,并调用开心网的开放API。

第三方移动应用程序还可以在登录界面、设置界面、注册界面等与用户登录相关的重要界面设置连接开心网按钮。相关图标请参考标识素材

3.4 iOS系统的移动应用接入

创建“客户端”应用后,使用开心网开放平台官方封装的开源iOS SDK(基于OAuth1.0a) 立即下载>>

iOS SDK是一个开源的objective-C库,通过这个库,你可以登录到开心网,并调用开心网开放的API。

第三方移动应用程序还可以在登录界面、设置界面、注册界面等与用户登录相关的重要界面设置连接开心网按钮。相关图标请参考标识素材

3.5 其它移动应用接入

创建“客户端”应用后,与普通web应用和桌面应用的验证授权方式基本相同,详细流程请参阅OAuth2.0文档相关介绍。

接口调用时,基本参数与平台相同,移动平台需要将用户的浏览器重定向到指定的url来展示登录授权页面。

3.6 常用API

目前,开心网开放平台已经正式发布了100多个API,包括发布记录(可带图)、发送动态、系统消息和邀请等大量功能接口。您可以尽量利用这些API,将社交功能融入到您的网站/客户端中,将精彩内容分享到开心网,强化社交性。

第三方经常用到的接口有:

功能分类接口名称接口说明
授权认证OAuth2.0授权流程
用户信息/users/me获取当前登录用户的资料
/users/show根据UID获取多个用户的资料
好友关系/friends/me获取当前登录用户的好友资料
应用信息/app/status获取用户安装应用的状态
/app/rate_limit_status查询当前APP剩余请求次数
平台基础功能/records/add发表一条记录(可带图)
/album/create创建一个照片专辑
/photo/upload上传一张照片到指定照片专辑
/gift/send在某个位置签到,并发出一条动态,与好友分享

3.7 功能测试

为防止不完整的功能外泄,影响用户体验,“连接网站”类应用在审核通过前,只有测试用户才能使用您网站的“开心连接”功能;审核通过后,才能为一般用户所使用。因此,您的网站正式发布“开心连接”功能前,请务必确认应用已经审核通过,否则一般用户将无法使用该功能。

请到应用的“开发人员管理”页面,添加开发人员;开发人员分为四类,每类对应不同的权限,请根据情况添加,详细如下表所示:

角色重置Secret Key删除应用添加开发人员编辑应用信息测试未上线的应用查看统计数据测试开心币人数上限
管理员2
开发者×××2
测试用户×××××10
数据用户××××××2

关于添加开发人员的方法,请参考添加开发人员说明

4. 提交审核

请务必完善应用信息后提交审核,开放平台工作人员会在1-2个工作日内,通过邮件或电话将审核结果告诉您。

5. 正式发布

应用审核通过后,您才能将网站/客户端的“开心连接”功能正式发布;如果您申请的应用未提交审核或审核未通过,您发布后,只能测试账号才能使用,一般用户无法使用该功能。