Altmetric API的Objective-C客户端。

SZNAltmetric是iOS和Mac OS X上的Altmetric API客户端。它是基于AFNetworking构建的，用于处理网络操作，并基于NSURLSession。

入门

开始使用最简单的方法是使用CocoaPods管理您的依赖项。按照CocoaPods网站上的说明安装gem，并在您的Podfile中指定SZNAltmetric作为依赖项。

pod 'SZNAltmetric', '~> 2.1'

示例用法

我们想要尽可能简单地将API中关于文章的详细信息获取出来，所以看起来是这样的

SZNAltmetricManager *manager = [SZNAltmetricManager sharedManager];

[manager
 fetchArticleWithDOI:@"###DOI###"
 success:^(SZNAltmetricArticle *article) {
     // We have the article,
     // we can log the Altmetric score
     NSLog(@"%@", [article.score stringValue]);
 }
 failure:nil];

如你所见，我们只是基于DOI请求了一篇文章。你得到的是包含所有标识符、Altmetric得分甚至“甜甜圈”图片URL的SZNAltmetricArticle对象。

客户端API密钥是可选的，如果需要，配置也很简单

SZNAltmetricManager *manager = [SZNAltmetricManager sharedManager];
manager.APIKey = @"###key###";

仅使用一点用户界面，这里是在iOS和OS X上看起来是这样的

您也可以使用不同类型的标识符（Altmetric ID、PubMed ID、arXiv ID和ADS Bibcode）或时间范围来搜索文章

SZNAltmetricManager *manager = [SZNAltmetricManager sharedManager];

[manager
 fetchArticlesCitationsWithTimeframe:@"1d"
 success:^(NSArray *articles, NSUInteger total, NSUInteger page) {
     // We have an array of articles.
     NSLog(@"%@", articles);
 }
 failure:nil];

参考

• 入门
• 文档
• 变更日志

要求

SZNAltmetric需要Xcode 6.3和iOS 7.0或OS X 10.9，以及AFNetworking和ISO 8601解析器/反解析器。SZNAltmetric和AFNetworking都使用ARC。

如果您需要支持较旧的操作系统版本

• SZNAltmetric 1.x支持iOS 5.0和OS X 10.7
• SZNAltmetric 2.0支持iOS 6.0和OS X 10.8

鸣谢

SZNAltmetric由Shazino开发。

许可证

SZNAltmetric 采用 MIT 许可协议。更多信息请参阅 LICENSE 文件。