/APIKit

A networking library for building type safe web API client in Swift.

Primary LanguageSwiftMIT LicenseMIT

APIKit

Build Status codecov Carthage compatible Version Platform

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

let request = SearchRepositoriesRequest(query: "APIKit", sort: .Stars)

Session.send(request) { result in
    switch result {
    case .success(let repositories):
        // Type of `repositories` is `[Repository]`,
        // which is inferred from `SearchRepositoriesRequest`.
        print(repositories)

    case .failure(let error):
        print(error)
    }
}

Requirements

  • Swift 3.0
  • 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.0 to your Cartfile.
  • Run carthage update.
  • Link your app with APIKit.framework and Result.framework in Carthage/Checkouts.

CocoaPods

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

Note: CocoaPods 1.1.0 is required to install APIKit 3.

Documentation

Advanced Guides

Migration Guides