TwitterAPIKit

TwitterAPIKit is a library to access Twitter API easily.

Thanks to

• APIKit
• HMAC

Use

1. Authorize
2. Access to API

Authorize

Twitter uses OAuth to provide authorized access to its API. There will first need to get request token.

let consumerKey = "xxxx"
let consumerSecret = "yyyy"
let callback = "callback://"

let client = OAuthRequestTokenClient(consumerKey: consumerKey, consumerSecret: consumerSecret) // (1)
let requestTokenRequet = TwitterOAuth.RequestToken(client: client, callback: callback) // (2)

Session.sendRequest(request){ result in
    switch result {
    case .Success(let response):

         ...

    }
} // (3)

(1) is a process to prepare client object. There is 3 type client object.

• OAuthRequestTokenClient is a client to access oauth/request_token.
• OAuthAccessTokenClient is a client to access oauth/access_token.
• OAuthAPIClient is a client to access some api.

(2) is a process to make Request. Please see APIKit Document if you want to know detail.
(3) is a process to access endpoint oauth/request_token. Trailing Closure is a response handling. result is a Result<T, E>. Please see APIKit Document too this.

Next, You have to open URL https://api.twitter.com/oauth/authorize.

let url = TwitterOAuth.authorizeURL(response.requestToken)
UIApplication.sharedApplication().openURL(url)

When you come back by callback, you have to get access token.

let client = OAuthAccessTokenClient(
    consumerKey: consumerKey,
    consumerSecret: consumerSecret,
    requestToken: response.requestToken,
    requestTokenSecret: response.requestTokenSecret
)
let accessTokenRequest = TwitterOAuth.AccessToken(client: client, verifier: verifier)

Session.sendRequest(accessTokenRequest){ result in
    switch result {
    case .Success(let response):

    let client = OAuthAPIClient(
        consumerKey: consumerKey,
        consumerSecret: consumerSecret,
        oauthToken: response.oauthToken,
        oauthTokenSecret: response.oauthTokenSecret
    )

    let user = User.withID(response.userID)

    /// You use this client when you access some API.
    /// Please use `User` if necessary.

    }
}

Access to API

You can access some API by using previous OAuthAPIClient object. Please see document when you want to know supported APIs.

License

Copyright (c) 2015 Yoshiki Kudo.
TwitterAPIKit is available under the MIT license. See the LICENSE file for more info.