Digits lets people create an account or sign into your app using nothing but their phone number on iOS and Android. Built using the same global, reliable infrastructure Twitter uses, Digits will verify the user’s phone number with a simple customizable user interface that easily integrates into your app.

Digits extends your existing user/profile database. A successful Digits account creation will return a stable userID to attach or match with your user record, and an oAuth token for the device. A verified phone number is also returned for convenience, but the user’s number may change at any time and should not be used for authentication.

Digits includes web login and signup support, as well as the ability for users to find their friends via their address books.

Release notes:

• Phone numbers are rate limited to normal consumer usage.

Set up Digits Authentication

Digits offers two ways to kick off the authentication flow: using a pre-configured button, or calling an authentication method from your own button’s tap handler.

Using the pre-configured button

In the view controller that will display the button, instantiate the pre-configured button DGTAuthenticateButton after the view is loaded (e.g. in the viewDidLoad method) and provide a completion block to handle the provided session object:

- (void)viewDidLoad {
  DGTAuthenticateButton *digitsButton = 
        [DGTAuthenticateButton buttonWithAuthenticationCompletion:^
        (DGTSession *session, NSError *error) {
      // Inspect session/error objects
  }];
  [self.view addSubview:digitsButton];
}

// Swift
override func viewDidLoad() {
    let digitsButton = DGTAuthenticateButton(
            authenticationCompletion: { (session, error) in
        // Inspect session/error objects
    })
    self.view.addSubview(digitsButton)
}

This will render a button that looks like:

Using your own button

In the view controller that displays your custom button, capture a tap event as usual and call the authenticateWithCompletion: method with the completion block that handles the session object:

- (void)didTapButton {
    [[Digits sharedInstance] authenticateWithCompletion:^
            (DGTSession* session, NSError *error) {
        if (session) {
            // Inspect session/error objects
        }
    }];
}

// Swift
func didTapButton(sender: AnyObject) {
    let digits = Digits.sharedInstance()
    digits.authenticateWithCompletion { (session, error) in
        // Inspect session/error objects
    }
}