SDK2/iossdk

跳转至: 导航搜索

目录

简介

renren-api2-sdk-ios是对人人 API 2.0 接口进行了一个简单封装,主要包括了 OAuth 2.0 认证、与人人官方客户端5.9.0及以上版本SSO登录,API接口调用。

RennSDK下载

Demo下载

更多下载

安装

1.将SDK导入到项目里面。

 将RennSDK.framework,资源 RennSDK.bundle 导入到工程中。

IosImport.png


2.工程设置

除了引用RennSDK.framework 还需要在工程引用iOS SDK的其它framework, 如下framework是必须的:

UIKit.framework

Foundation.framework

CoreGraphics.framework


3.在需要使用SDK的文件中导入以下头文件

#import "RennSDK/RennSDK.h"


4.配置SSO

使用SSO功能实现单点登录人人,需要在目标工程的Info.plist中增加URL types键值,并添加URL Schemes,输入值rm[app_id][app_bundle_id], [app_id] 为申请的应用程序id号, [app_bundle_id]为开发者应用的Bundle identifier(中括号要去掉)。 例如app_id为168802, app_bundle_id为com.renren.Demo,这里就应该输入”rm168802com.renren.Demo”


IosURLTypes.png


在AppDelegate.m文件中增加以下方法:

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {

   return [RennClient  handleOpenURL:url];

}

使用说明

  • 初始化RennClient:
[RennClient initWithAppId:@"APP_ID" apiKey:@"API_KEY" secretKey:@"SECRET_KEY"];
  • 设置权限范围(可选):
[RennClient setScope:@"read_user_album read_user_status"];
    权限请参考'权限列表',如果不设置则使用默认权限
  • 设置Token类型(可选):
[RennClient setTokenType:@"bearer"]; //使用bearer token
    如果使用mac token,设置为:
[RennClient setTokenType:@"mac"]; //使用mac token
  • 登录:
[RennClient loginWithDelegate:self];
  • 处理登陆结果,实现以下委托方法:
- (void)rennLoginSuccess - (void)rennLogoutSuccess
  • 调用接口,以发布一条新鲜事为例:
PutFeedParam *param = [[[PutFeedParam alloc] init] autorelease];

param.title = @"新鲜事Title"; param.description = @"新鲜事Description"; param.message = @"这是一条新鲜事"; param.targetUrl = @"http://www.56.com/u72/v_OTAyNTkxMDk.html";

[RennClient sendAsynRequest:param delegate:self];
  • 处理返回结果,实现以下委托方法:
- (void)rennService:(RennService *)service requestSuccessWithResponse:(id)response - (void)rennService:(RennService *)service requestFailWithError:(NSError*)error

返回结果

Response返回数组 {"response":[{},{},…]} NSArray
Response返回结构 {"response":{}} NSDictionary
Response返回结果 {"response":1/0} NSNumber

请求参数列表

接口分类 接口名 请求参数
app /v2/app/get GetAppParam
status /v2/status/list ListStatusParam
/v2/status/get GetStatusParam
/v2/status/put PutStatusParam
/v2/status/share ShareStatusParam
album /v2/album/get GetAlbumParam
/v2/album/put PutAlbumParam
/v2/album/list ListAlbumParam
like /v2/like/ugc/remove RemoveLikeParam
/v2/like/ugc/put PutLikeParam
blog /v2/blog/list ListBlogParam
/v2/blog/put PutBlogParam
/v2/blog/get GetBlogParam
photo /v2/photo/upload UploadPhotoParam
/v2/photo/get GetPhotoParam
/v2/photo/list ListPhotoParam
share /v2/share/ugc/put PutShareUgcParam
/v2/share/url/put PutShareUrlParam
/v2/share/get GetShareParam
/v2/share/hot/list ListHotShareParam
/v2/share/list ListShareParam
notification /v2/notification/user/put PutNotificationAsUserParam
/v2/notification/app/put PutNotificationAsAppParam
ubb /v2/ubb/list ListUbbParam
feed /v2/feed/put PutFeedParam
/v2/feed/list ListFeedParam
comment /v2/comment/list ListCommentParam
/v2/comment/put PutCommentParam
user /v2/user/batch BatchUserParam
/v2/user/friend/mutual/list ListUserFriendMutualParam
/v2/user/get GetUserParam
/v2/user/friend/app/list ListUserFriendAppParam
/v2/user/friend/list ListUserFriendParam
/v2/user/login/get GetUserLoginParam
profile /v2/profile/get GetProfileParam