Description of JSMS iOS SDK API

Obtain SMS Verification Code

+ (void)getVerificationCodeWithPhoneNumber:(NSString * _Nonnull)number 
                             andTemplateID:(NSString * _Nonnull)templateID
                         completionHandler:(JSMSCompletionHandler _Nonnull)handler;

Interface Description

Get interface of SMS verification code: Create a button to get the SMS verification code, or call the SMS verification code in the button event of the existing interface.

Parameter Description

• number: Mobile number

• templateID: SMS template ID

• handler: The callback of request or request failure

Call Example

//点击获取短信验证码
 - (IBAction)sendSmsAuthCode:(id)sender {
     [JSMSSDK getVerificationCodeWithPhoneNumber:@"152xxxxxxxx" andTemplateID:@"1" completionHandler:^(id resultObject, NSError *error) {
         if (!error) {
             NSLog(@"Get verification code success!");
         }else{
             NSLog(@"Get verification code failure!");
             NSLog(@"%@",error);
         }
     }];
 }

Get Voice Verification Code

+ (void)getVoiceVerificationCodeWithPhoneNumber:(NSString * _Nonnull)number
                              completionHandler:(JSMSCompletionHandler _Nonnull)handler;

Interface Description

Interface for obtaining voice verification code: Create button to get voice verification code, or call the method to get voice verification code in button event of existing interface

Parameter Description

• number: Mobile number

• handler: The callback of request or request failure

Call Example

//点击获取语音验证码
 - (IBAction)sendVoiceAuthCode:(id)sender {
     [JSMSSDK getVoiceVerificationCodeWithPhoneNumber:@"152xxxxxxxx" completionHandler:^(id resultObject, NSError *error) {
         if (!error) {
             NSLog(@"Get voice verification code success!");
         }else{
             NSLog(@"Get voice verification code failure!");
             NSLog(@"%@",error);
         }
     }];
 }

Get Voice Verification Code (broadcast language can be set)

+ (void)getVoiceVerificationCodeWithPhoneNumber:(NSString * _Nonnull)number
                                languageOptions:(JSMSLanguageOptions)options
                              completionHandler:(JSMSCompletionHandler _Nonnull)handler;

Interface Description

Interface for obtaining voice verification code: Create button to get voice verification code, or call the method to get voice verification code in button event of existing interface

Parameter Description

• number: Mobile number

• options: Broadcast language. When the parameter is invalid, default language is Chinese

• handler: The callback of request or request failure

Call Example

//点击获取语音验证码
 - (IBAction)sendVoiceAuthCode:(id)sender {
     [JSMSSDK getVoiceVerificationCodeWithPhoneNumber:@"152xxxxxxxx"
                                         languageOptions:JSMSLanguage_zh_Hans
                                       completionHandler:^(id resultObject, NSError *error) {
         if (!error) {
             NSLog(@"Get voice verification code success!");
         }else{
             NSLog(@"Get voice verification code failure!");
             NSLog(@"%@",error);
         }
     }];
 }

Verify Verification Code

+ (void)commitWithPhoneNumber:(NSString * _Nonnull)number
             verificationCode:(NSString * _Nonnull)vCode
            completionHandler:(JSMSCompletionHandler _Nonnull)handler;

Interface Description

Verify verification code: Create a button to submit a verification code, or call a verification code in a button event of an existing interface.

Parameter Description

• number: Mobile number

• vCode: SMS verification code

• handler: The callback of request or request failure

Call Example

//验证验证码 
 [JSMSSDK commitWithPhoneNumber:@"152xxxxxxxx" verificationCode:@"123456" completionHandler:^(id resultObject, NSError *error) {
      if (!error) {
           NSLog(@"Commit verification vode success!");
      }else{
           NSLog(@"%@",error);
           NSLog(@"Commit verification code failure!");
      }
 }];

Set the Interval of Verification Code Request

+ (void)setMinimumTimeInterval:(NSTimeInterval)seconds;

Interface Description

Set the interface for obtaining the interval of verification code request: You can only send the request to obtain the verification code within the set interval once. If you do not call this interface, default interval of sdk is 30s

Parameter Description

• seconds: Interval

Call Example

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
      [JSMSSDK setMinimumTimeInterval:60];
      return YES;
 }

Description of Error Code