Edited at

Github Search Repository with swift and APIKit

Introduction to APIKit

I am going to give a brief introduction of APIKit with swift, APIKit is a type-safe networking abstraction layer that associates request type with response type which simplifies the design and implementation of REST APIs.

Demo Code

protocol RequestType: APIKit.Request {}

extension RequestType {

/// Base URL
var baseURL: URL {
return URL(string: "https://api.github.com")!

/// Header
var headerFields: [String : String] {
return [
"Accept": "application/json",
"Accept-Encoding": "gzip"

func intercept(urlRequest: URLRequest) throws -> URLRequest {
return urlRequest

func intercept(object: Any, urlResponse: HTTPURLResponse) throws -> Any {
guard (200..<300).contains(urlResponse.statusCode) else {
throw APIError(object: object)
return object


// MARK: - JSON Decode
extension RequestType where Response: Himotoki.Decodable {
func response(from object: Any, urlResponse: HTTPURLResponse) throws -> Self.Response {
return try decodeValue(object)

This APIClient Class will return to the Session Class for responding the data.

struct APIClient {

public static var configuration = URLSessionConfiguration.default

static var session: Session {
self.configuration.urlCache?.diskCapacity = 0
self.configuration.urlCache?.memoryCapacity = 0

return Session(adapter: URLSessionAdapter(configuration: configuration))

struct Fetch {
static func get(query: String) -> Observable<APIClient.Fetch.ResponseFetchRepositoryDecode> {
return Session.sendRequest(
request: Fetch.GetFetchRepositoryRequest(query: query)

This is where we transform APIKit Session Class into Rx System so that we can use Observable for data response.

extension Session {

func sendRequest<T: Request>(request: T) -> Observable<T.Response> {
return Observable.create{ [unowned self] observer in
let task = self.send(request) { result in
switch result {

case .success(let response):

case .failure(.responseError(let apiError as APIError)):

case .failure(let error):
return Disposables.create {

static func sendRequest<T: Request>(request: T) -> Observable<T.Response> {
return Session.shared.sendRequest(request: request)


Sample Github Search Repository using APIKit

Within this sample project, you can search any repositories in github, I am using APIKit in this project to request github API and response as webview. Maybe next sample I will use Moya lib instead of APIKit.


In podfile, the add the following lines:

# auto layoutp

pod 'SnapKit'

# Rx
pod 'ReactorKit'
pod 'RxCocoa'
pod 'RxSwift'

# APIKit
pod 'APIKit'
pod 'Himotoki'
pod 'Result'

# Swift Initializer
pod 'Then'

Sample Demo


Here is the Sample Code Github Here!!! Feel Free to check with this sample :D