damozhang / APIKit

Type-safe networking abstraction layer that associates request type with response type.

APIKit

APIKit is a type-safe networking abstraction layer that associates request type with response type.

// SearchRepositoriesRequest conforms to Request protocol.
let request = SearchRepositoriesRequest(query: "swift")

// Session receives an instance of a type that conforms to Request.
Session.send(request) { result in
    switch result {
    case .success(let response):
        // Type of `response` is `[Repository]`,
        // which is inferred from `SearchRepositoriesRequest`.
        print(response)

    case .failure(let error):
        self.printError(error)
    }
}

Requirements

• Swift 3.0 or later
• iOS 8.0 or later
• Mac OS 10.10 or later
• watchOS 2.0 or later
• tvOS 9.0 or later

If you use Swift 2.2 or 2.3, try APIKit 2.0.5.

Installation

Carthage

• Insert github "ishkawa/APIKit" ~> 3.1 to your Cartfile.
• Run carthage update.
• Link your app with APIKit.framework and Result.framework in Carthage/Build.

CocoaPods

• Insert pod 'APIKit', '~> 3.1' to your Podfile.
• Run pod install.

Note: CocoaPods 1.1.0 is required to install APIKit 3.

Documentation

• Getting started
• Defining Request Protocol for Web Service
• Convenience Parameters and Actual Parameters

Advanced Guides

• Customizing Networking Backend

Migration Guides

• APIKit 3 Migration Guide
• APIKit 2 Migration Guide