关于ios:MobTech-SMSSDK-iOS端-API

回传用户隐衷受权后果（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: 办法，即可校验输出号码是否是本机号码。