MobTech 短信验证 iOS 端 SDK API
作者:MobTech袤博科技
- 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:方法,即可校验输入号码是否是本机号码。
划线
评论
复制
发布于: 刚刚阅读数: 7
MobTech袤博科技
关注
还未添加个人签名 2019.05.08 加入
还未添加个人简介
评论