ARDReadabilityClient
是一个针对流行服务 Readability.com 的简单 API。API 允许列出用户的书签,获取文章内容,修改书签等。该 API 基于 AFNetworking
的 AFHTTPClient
和 Readability 网页 API。
首先,您需要获取您的应用客户密钥和客户密钥。为此,通过访问链接https://www.readability.com/developers/api注册您的应用,并从那里获取密钥。只需 2 分钟。获取它们后,就可以开始使用 ARDReadabilityClient
了。
创建一个 ARDReadabilityClient
实例
readability = [[ARDReadabilityClient alloc] initWithBaseURL:[NSURL URLWithString:@"https://www.readability.com/api/rest/v1/"]
consumerKey:Your_Consumer_Key
consumerSecret:Your_Cunsumer_Secret];
并验证用户
[readability authenticateWithUserName:self.userNameTextField.text
password:self.passwordTextField.text
success:^(AFHTTPRequestOperation *operation, NSString *token, NSString *secret) {
NSLog(@"User is authenticated!");
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
//Something bad happens, check out the error
NSLog("Failed to authenticate the user: %@", error);
}];
您将获得一个用户令牌和一个令牌密钥。如果您想在会话之间保持用户验证,请保存收到的令牌和密钥。
警告:Readability 强烈建议不要在任何地方存储用户的密码。
因此,下次您需要为相同用户创建一个新实例的 ARDReadabilityClient
,只需使用保存的令牌和密钥的另一个初始化器即可
self.readability = [[ARDReadabilityClient alloc] initWithBaseURL:[NSURL URLWithString:@"https://www.readability.com/api/rest/v1/"]
token:The_Token
tokenSecret:The_Secret
consumerKey:Your_Consumer_Key
consumerSecret:Your_Cunsumer_Secret];
在 ARDReadabilityClient
获取用户令牌和密钥后,它就准备就绪了。您可以轻松下载用户的书签列表
[self.readability bookmarksUpdatedSince:[NSDate distantPast] sucess:^(NSArray *opeations, NSArray *bookmarks) {
foreach(ARDReadabilityBookmark *bookmark in bookmarks) {
NSLog(@"%@", bookmark.articleTitle);
}
} failure:^(AFHTTPRequestOperation *erroneousOpeation, NSError *error) {
NSLog("Failed to get bookmarks: %@", error);
}];
下载特定文章的内容
[self.readability articleContentByArticleId:self.articleId success:^(AFHTTPRequestOperation *operation, NSString *content) {
NSLog(@"%@", content);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog("Failed to get article content: %@", error);
}];
还有许多其他的事情,这些都非常易于使用。请检查 ARDReadabilityClient.h
文件以发现所有这些功能。在项目目录中,您还可以找到一个简单的示例。
CocoaPods 是将 ARDReadabilityClient
添加到您的项目的最简单方法。
只需将其添加到您的 Podfile 中
pod 'ARDReadabilityClient', '~> 0.2'
然后运行 pod update
另一种方法是直接将 ARDReadabilityClient
文件夹复制到您的项目中。在这种情况下,应将 AFNetworking
2.2 版添加到您的项目中。
请提交任何问题,我会尽快处理。此外,所有可以改善 ARDReadabilityClient 的 pull request 都受到欢迎。