UberKit - GitLite

KO | EN

gitlite — search

#developer-tools #database #kubernetes #security #automation #json #editor #chatbot #claude-code #html

UberKit

(★ 94)

An easy-to-use Objective-C wrapper for the Uber API (no longer supported)

파일 탐색기

ZIP 다운로드

- - UberActivity.h
  - UberActivity.m
  - UberPrice.h
  - UberPrice.m
  - UberProduct.h
  - UberProduct.m
  - UberProfile.h
  - UberProfile.m
  - UberPromotion.h
  - UberPromotion.m
  - UberTime.h
  - UberTime.m
- - NSData+NXOAuth2.h
  - NSData+NXOAuth2.m
  - NSString+NXOAuth2.h
  - NSString+NXOAuth2.m
  - NSURL+NXOAuth2.h
  - NSURL+NXOAuth2.m
  - NXOAuth2.h
  - NXOAuth2AccessToken.h
  - NXOAuth2AccessToken.m
  - NXOAuth2Account+Private.h
  - NXOAuth2Account.h
  - NXOAuth2Account.m
  - NXOAuth2AccountStore.h
  - NXOAuth2AccountStore.m
  - NXOAuth2Client.h
  - NXOAuth2Client.m
  - NXOAuth2ClientDelegate.h
  - NXOAuth2Connection.h
  - NXOAuth2Connection.m
  - NXOAuth2ConnectionDelegate.h
  - NXOAuth2Constants.h
  - NXOAuth2Constants.m
  - NXOAuth2FileStreamWrapper.h
  - NXOAuth2FileStreamWrapper.m
  - NXOAuth2PostBodyPart.h
  - NXOAuth2PostBodyPart.m
  - NXOAuth2PostBodyStream.h
  - NXOAuth2PostBodyStream.m
  - NXOAuth2Request.h
  - NXOAuth2Request.m
  - NXOAuth2TrustDelegate.h
  - OAuth2Client_Prefix.pch
- UberKit.h
- UberKit.m
- - main.m
  - UberKitDemo-Info.plist
  - UberKitDemo-Prefix.pch
  - UberKitDemoAppDelegate.h
  - UberKitDemoAppDelegate.m
  - ViewController.h
  - ViewController.m
- - project.pbxproj
- - UberKitDemoTests-Info.plist
  - UberKitDemoTests.m
LICENSE
Login screenshot.png
README.md
UberKit.podspec

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`pod`

설명 보기 ▼

Swift 및 Objective-C Cocoa 프로젝트를 위한 종속성 관리 도구.
더 많은 정보: <https://guides.cocoapods.org/terminal/commands.html>.

pod init

현재 프로젝트에 기본 내용으로 Podfile 생성:

pod install

Podfile에 정의된 모든 포드를 다운로드 및 설치 (이전에 설치되지 않은 경우):

pod list

사용 가능한 모든 포드 나열:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

UberKit
=======

UberKit is a simple Objective-C wrapper for the new <a href = http://developer.uber.com> Uber API </a>.

<h1> Installation </h1>
<h3> Cocoapods </h3>
UberKit is available through <a href = "cocoapods.org"> Cocoapods</a>. To install it, simply add the following to your Podfile.
```
pod 'UberKit'
```
<h3> Alternative </h3>
Alternatively, you can always just drag and drop the folder 'UberKit' into your project and ``#import "UberKit.h"`` and you're good to go.

<h2> Basic API Implementation </h2>

This is to implement the Uber API without having users sign in to their Uber account.

To implement UberKit, first initialize it with your server token.

You can get your server token from <a href = http://developer.uber.com> Uber Developers</a>.

```objc
  UberKit *uberKit = [[UberKit alloc] initWithServerToken:@"YOUR_SERVER_TOKEN"];
```
Alternatively, you can set your server token to a shared instance of UberKit as follows:
```objc
    [[UberKit sharedInstance] setServerToken:@"YOUR_SERVER_TOKEN"];
```

To get all products available from a particular location

```objc
 [uberKit getProductsForLocation:location withCompletionHandler:^(NSArray *products, NSURLResponse *response, NSError *error)
     {
         if(!error)
         {
             //Got the array of available products for the location.
         }
         else
         {
             NSLog(@"Error %@", error);
         }
     }];
```

To get the time for arrival of a product to a particular location
```objc
[uberKit getTimeForProductArrivalWithLocation:location withCompletionHandler:^(NSArray *times, NSURLResponse *response, NSError *error)
     {
         if(!error)
         {
             //Got the array of available products and the time they'll take to reach the mentioned location.
         }
         else
         {
             NSLog(@"Error %@", error);
         }
     }];
```

To get the price for a trip between two locations
```objc
[uberKit getPriceForTripWithStartLocation:location endLocation:endLocation  withCompletionHandler:^(NSArray *prices, NSURLResponse *response, NSError *error)
     {
         if(!error)
         {
             //Got the array of available products and the price of a trip from the start location to the end location.
         }
         else
         {
             NSLog(@"Error %@", error);
         }
     }];
```

To get the available promotion for a trip between two locations
```objc
[uberKit getPromotionForLocation:location endLocation:endLocation withCompletionHandler:^(UberPromotion *promotion, NSURLResponse *response,  NSError *error)
     {
        if(!error)
        {
            //Got the promotion as an UberPromotion
        }
        else
        {
            NSLog(@"Error %@", error);
        }
     }];
```

<h2> OAuth implementation </h2>

<h3> Introduction </h3>

This is to implement the Uber API with endpoints that require user authorization such as user history and profile.
The authorization process is implemented by:

1. Allowing the users to sign in to their Uber accounts.

2. Obtaining an access token on user approval of app's permissions.

3. Using this access token to make calls to the Uber API.

UberKit automatically redirects to Safari where users enter their Uber login credentials to allow access to their profiles.

<img src = "https://github.com/sachinkesiraju/UberKit/blob/master/Login%20screenshot.png" width = "320px">

<h3> Implementation </h3>

Before you can get started using UberKit with login parameters, you must first create an Uber application at <a href = http://developer.uber.com> Uber Developers </a> and fill in all necessary fields.

<b> [Note: To gain access to the user's profile and history, ensure that you have these permissions enabled in your app's dashboard] </b>

To implement UberKit with authorization from the user first initialize it with your client id, client secret, redirect URI and application name from the application you made on Uber Developer.

```objc
UberKit *uberKit = [[UberKit alloc] initWithClientID:@"YOUR_CLIENT_ID" ClientSecret:@"YOUR_CLIENT_SECRET" RedirectURL:@"YOUR_REDIRECT_URL" ApplicationName:@"YOUR_APPLICATION_NAME"]; //Set these fields from your app on Uber Developers.
uberKit.delegate = self; //Set the delegate (only for login)
```

Add the UberKit delegate to the @interface of your view controller to detect when an Uber access token becomes available for use after successful authorization. Then, you must add the following methods to your view controller:
```objc
- (void) uberKit: (UberKit *) uberKit didReceiveAccessToken: (NSString *) accessToken
{
    //Got the access token, can now make requests for user data
}
- (void) uberKit: (UberKit *) uberKit loginFailedWithError: (NSError *) error
{
    //An error occurred in the login process
}
```
You can also retrieve the access token when it is available by using `NSString *token = [[UberKit sharedInstance] getStoredAuthToken];`

To begin the login process, call the method 'startLogin' using `[uberKit startLogin];`

Once you've successfully retrieved an access token, you can then make the following calls to the Uber API :

To get all activity by the user
```objc
[uberKit getUserActivityWithCompletionHandler:^(NSArray *activities, NSURLResponse *response, NSError *error)
         {
             if(!error)
             {
                 //Got an array of the history of activities performed by the user
             }
             else
             {
                 NSLog(@"Error %@", error);
             }
         }];
```

To get the profile of the user
```objc
[uberKit getUserProfileWithCompletionHandler:^(UberProfile *profile, NSURLResponse *response, NSError *error)
         {
             if(!error)
             {
                 //Got the user's profile as an UberProfile
             }
             else
             {
                 NSLog(@"Error %@", error);
             }
         }];
```

For more help, check out the <a href = https://github.com/sachinkesiraju/UberKit/tree/master/UberKitDemo> Demo </a>!

For any assistance, reach out to me on Twitter <a href = https://twitter.com/sachinkesiraju> @sachinkesiraju </a>

<h2> Featured In </h2>

- <a href = http://blindsquare.com/>Blindsquare </a>

Let me know where you use UberKit so I can add it here!

<h2> Community </h2>

If you feel that you can contribute to improving UberKit or add a new feature, feel free to raise an issue/submit a PR.

<h2> License </h2>

UberKit is available under the MIT License. See the <a href = https://github.com/sachinkesiraju/UberKit/blob/master/LICENSE>LICENSE</a> for more information.