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 添加到项目的方法是将 ARDReadabilityClient 文件夹复制到您的项目中。在这种情况下，应将 AFNetworking 版本 2.2 添加到您的项目中。
请提交任何问题，我将尽快解决它们。同时，所有提高 ARDReadabilityClient 的拉取请求都欢迎。