写点什么

MobTech 短信验证 iOS 端 SDK API

  • 2022 年 8 月 31 日
    上海
  • 本文字数:2249 字

    阅读完需:约 7 分钟

回传用户隐私授权结果(uploadPrivacyPermissionStatus)

/** 上传隐私协议授权状态 @param isAgree 是否同意(用户授权后的结果) @param OnResult 执行回调结果,可为nil (注意业务逻辑不要依赖于这个success结果,建议业务逻辑在调用这个接口之后来写) */+ (void)uploadPrivacyPermissionStatus:(BOOL)isAgree                                                 onResult:(void (^_Nullable)(BOOL success))handler;
复制代码


示例代码


#import <MOBFoundation/MobSDK+Privacy.h>[MobSDK uploadPrivacyPermissionStatus:YES onResult:^(BOOL success) {}];
复制代码

请求短信验证码(getVerificationCodeByMethod)

/** *  @from                    v3.1.0 *  @brief                   获取验证码(Get verification code) * *  @param method            获取验证码的方法(枚举值:SMSGetCodeMethodSMS 文本短信方式 SMSGetCodeMethodVoice 语音验证码) *  @param phoneNumber       电话号码(The phone number) *  @param zone              区域号,不要加"+"号(Area code) *  @param tmpCode           模板id(template id) *  @param result            请求结果回调(Results of the request) */+ (void) getVerificationCodeByMethod:(SMSGetCodeMethod)method                                      phoneNumber:(NSString *)phoneNumber                                                     zone:(NSString *)zone                                               template:(NSString *)tmpCode                                                    result:(SMSGetCodeResultHandler)result;
复制代码


示例代码


#import <SMS_SDK/SMSSDK.h>  //template参数不能乱填,没有可以先传""或者nil,SMSGetCodeMethodSMS文本短信方式 SMSGetCodeMethodVoice 语音验证码  [SMSSDK getVerificationCodeByMethod:SMSGetCodeMethodSMS phoneNumber:@"XXXXXXXXXXX" zone:@"86" template:@"" result:^(NSError *error) {        if (!error)        {            // 请求成功        }        else        {            // error        }    }];
复制代码


注:模板 id 在官网后台 SMSSDK 产品下的短信模版里面添加(需要申请过自定义短信签名的应用才能添加短信模板)

提交验证码验证(commitVerificationCode)

/** * @from                    v1.1.1 * @brief                   提交验证码(Commit the verification code) * * @param code              验证码(Verification code) * @param phoneNumber       电话号码(The phone number) * @param zone              区域号,不要加"+"号(Area code) * @param result            请求结果回调(Results of the request) */+ (void) commitVerificationCode:(NSString *)code                            phoneNumber:(NSString *)phoneNumber                                           zone:(NSString *)zone                                          result:(SMSCommitCodeResultHandler)result;
复制代码


示例代码


[SMSSDK commitVerificationCode:@"XXXX" phoneNumber:@"XXXXXXXXXXX" zone:@"86"result:^(NSError *error) {        if (!error)        {            // 验证成功        }        else        {            // error        }    }];
复制代码


**注意:必须要自己重新自定义签名,默认签名仅用于测试,不保证到达率,上线前请务必申请自定义签名使用

请求手机号码认证 Token

/**
* @brief 请求手机号码认证Token ** @param handler 请求结果回调(Results of the request) */
+ (void) getMobileAuthTokenWith:(SMSSDKMobileAuthTokenResultHandler)handler;
/**
* @brief 请求本机认证Token结果回调 * @param model 包含token的具体信息 * @param error 为空时表示请求成功 */ typedef void(^SMSSDKMobileAuthTokenResultHandler)(SMSSDKAuthToken *model, NSError *error);
复制代码


示例代码


[SMSSDK getMobileAuthTokenWith:^(SMSSDKAuthToken *model, NSError *error) {}
复制代码

验证手机号

/***  @brief                   验证手机号   **  @param phoneNum          电话号码(The phone number)*  @param tokenInfo         SDK返回的SMSSDKAuthToken Model*  @param completion        请求结果回调(Results of the request)   */
+ (void) verifyMobileWithPhone:(NSString *)phoneNum token:(SMSSDKAuthToken *)tokenInfo completion:(SMSSDKMobileVerifyResultHandler)completion;
/**
* @brief 手机号码验证结果回调* @param isValid 是否验证成功 YES成功 NO失败* @param error 为空时表示请求成功 */ typedef void(^SMSSDKMobileVerifyResultHandler)(BOOL isValid, NSError *error);
复制代码


示例代码


[SMSSDK verifyMobileWithPhone:@"XXXX"                                              token:@"XXXX"                                     completion:^(BOOL isValid, NSError *error) {}
复制代码


a. 用户可通过 getMobileAuthTokenWith 方法来获取对应运营商的本机认证 token、mobToken 和 operator


b. 用户可通过将手机号码及在步骤 a 中获取的 token 信息传给 verifyMobileWithPhone:token:completion:方法,即可校验输入号码是否是本机号码。

用户头像

还未添加个人签名 2019.05.08 加入

还未添加个人简介

评论

发布
暂无评论
MobTech 短信验证iOS端SDK API_ios_MobTech袤博科技_InfoQ写作社区