本机号码校验

接口列表

本机号码校验

整体流程

本机号码校验需要先获取通行证，然后再进行本机号码校验。

获取本机号码校验通行证

/**
 * 获取本机号码校验所需要的 processID 和 token
 * @param pn 待校验手机号码
 * @param callback 回调
 * {
 *  code: 30000, //NSNumber, 非30000为失败
 *  msg: "success" // NSString, 返回信息
 *  phone: "1333333333" // NSString, 输入的手机号
 *  token: "xxx" // NSString, 授权凭证
 *  processID: "xxx" // NSString, 流水号
 *  operatorType = 4; // NSString, 操作类型
 * }
 */
+ (void)getPhoneVerifyToken:(NSString *_Nonnull)pn andCallback:(GyVerifyCallback _Nonnull)callback;

输入参数

调用示例

[GeYanSdk getPhoneVerifyToken:pn andCallback:^(NSDictionary *result) {
        NSLog(@"%@", result);
}];    

返回示例

GyVerifyCallback返回结果示例:

{
  "code" : 30000,
  "phone" : "17357981821",
  "operatorType" : 3,
  "msg" : "success",
  "processID" : "7da6378c8637406ffec002c433c52b1a",
  "token" : "nm59b1598ae1e0465da3db485354166c55"
}

• 属性详细说明：

本机号码校验接口

/**
 * 本机号码校验,本接口为客户端校验手机号使用
 * 若需要服务端校验手机号码,请使用 getPhoneVerifyToken:andCallback 获取 相关参数
 * @param pn 待校验手机号码
 * @param token getPhoneVerifyToken 返回的 token
 * @param processId getPhoneVerifyToken 返回的processId
 * @param opType getPhoneVerifyToken 返回的opType
 * @param callback 回调
 * {
 *  code: 30000, //NSNumber, 非30000为失败
 *  msg: "success" // NSString, 返回信息
 * }
 */
+ (void)checkPhoneNumber:(NSString *)pn withToken:(NSString *)token withProcessId:(NSString *)processId withOperatorType:(NSString *)opType andCallback:(GyVerifyCallback)callback;

我们还提供了服务端的本机号码校验接口，如果开发者有这方面的需求，请参考服务端的文档。

输入参数

调用示例

[GeYanSdk checkPhoneNumber:result[@"phone"] withToken:result[@"token"] withProcessId:result[@"processID"] withOperatorType:result[@"operatorType"] andCallback:^(NSDictionary *verifyDictionary) {
                NSLog(@"%@", verifyDictionary);
            }];

返回示例

GyVerifyCallback返回结果示例:

{
  "msg" : "成功",
  "code" : 30000
}

• 属性详细说明：

状态码

SDK返回码

错误码

其余情况请参考状态码汇总说明

常见问题

建议开发者在开发期间开启debug模式，通过查看debug日志，可以更好的排查问题。

[GeYanSdk setDebug:YES];

一键登录和本机号码校验支持哪些运营商和网络环境

目前支持移动 2G、3G、4G、5G，联通 3G、4G、5G，电信 4G、5G。

是否支持双卡手机

支持，双卡手机以开启数据流量的 SIM 卡进行认证。

WIFI环境下能否验证

在数据网络开通的前提下，WiFi 环境中会强制使用数据网络触发网关请求，请求仅为几K，可正常校验。

是否支持携号转网用户

SDK 不提供接口判断用户是否为携号转网用户，但可以判断用户流量卡当前的运营商。即携号转网用户可正常使用。

是否支持虚拟运营商

仅支持三大运营商（移动、联通、电信）的手机号进行一键登录。

是否支持流量卡

三大运营商（移动、联通、电信）的卡，能够正常使用数据网络，运营商通过网关能够正常取号，均会被作为正常的卡来判断。