ARDReadabilityClient 0.2

ARDReadabilityClient 0.2

测试已测试
语言语言 Obj-CObjective C
许可证 MIT
发布上次发布2014 年 12 月

未声明 维护。



  • Andrew Slabko

ARDReadabilityClient 是一个针对流行服务 Readability.com 的简单 API。API 允许列出用户的书签,获取文章内容,修改书签等。该 API 基于 AFNetworkingAFHTTPClient 和 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 都受到欢迎。