CiNiiKit

Build Status CocoaPods MIT License CocoaPods Carthage compatible

使用 Swift 编写的 CiNii API 客户端。

开始使用

CiNii Article 搜索示例,

import CiNiiKit

let cinii: CiNiiKit = CiNiiKit.shared
cinii.register(key: "ENTER YOUR API KEY")
let keyword: String = "ENTER YOUR SEARCH WORD"
cinii.articles.search(keyword: keyword, success: { model in
 	// e.g. get first journal title
 	print(model.graph[0].items?[0].title)
}, failure: { error in
	print(error)
})

演示

演示应用是 CiNii Articles 的一个示例。

支持

完全支持 CiNii APIs!

在调用方法中支持多个查询参数,

CiNii Articles

  1. search()

    从 CiNii Articles 获取搜索文章的结果。

  2. author()

    从 CiNii Articles 获取搜索作者的结果。

  3. fulltext()

    从 CiNii Articles 获取搜索全文的结果。

CiNii Books

  1. search()

    从 CiNii Books 获取搜索书籍的结果。

  2. author()

    从 CiNii Books 获取搜索作者的结果。

  3. library()

    从 CiNii Books 获取搜索图书馆的结果。

  4. holding()

    从 CiNii Books 获取搜索馆藏的结果。

CiNii Dissartations

  1. search()

    从 CiNii Dissertations 获取搜索论文的结果。

安装

Cocoapods

将此添加到您的 Podfile

pod 'CiNiiKit'

$ pod install

Carthage

将此添加到您的 Cartfile

github "YutoMizutani/CiNiiKit"

$ carthage update

用法 HTTP

CiNii API 使用 HTTP 连接。

App Transport Security 阻止了明文 HTTP (http://) 资源加载,因为它不安全。可以通过应用程序的 Info.plist 文件配置临时例外。

将其写入您的 Info.plist

<key>NSAppTransportSecurity</key>
<dict>
	<key>NSAllowsArbitraryLoads</key>
	<false/>
	<key>NSExceptionDomains</key>
	<dict>
		<key>ci.nii.ac.jp</key>
		<dict>
			<key>NSIncludesSubdomains</key>
			<true/>
			<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
			<true/>
			<key>NSTemporaryExceptionRequiresForwardSecrecy</key>
			<false/>
		</dict>
	</dict>
</dict>

获取 API 密钥

此 API 需要密钥(应用程序 ID)。请在此页面注册。

参考

许可证

CiNiiKit 在 MIT 许可证下可用。