iOS系统如何集成CIA易验证SDK?

2025-12-15 05:50:43

1、SDK功能说明

1、架构设计

2、主要功能

本SDK主要提供以下功能接口

1、 初始化服务:初始化SDK,以便后续的验证操作。

2、 请求验证:发起一个验证手机号的请求。用户的验证手机会收到一个呼入电话,这时候SDK会回调,进入验证码模式,需要用户输入呼入电话号码的后4位作为验证码。

3、 获取验证码:为了更好的提示用户,可以调用SDK的获取验证码(呼入的电话号码)来提示用户哪个号码将会呼入。

4、 校验验证码:校验用户输入的验证码是否正确。

iOS系统如何集成CIA易验证SDK?

2、开发前准备

运行环境

可运行于iOS 6 及以上版本。

账户申请及权限开通

1、获取方式

打开CIA易验证官网,注册账户并登录到开发者后台。

2、获取appId 和 authKey

进入开发者后台。

iOS系统如何集成CIA易验证SDK?

iOS系统如何集成CIA易验证SDK?

iOS系统如何集成CIA易验证SDK?

3、使用SDK开发应用

添加SDK到APP工程

1、 创建一个iOS Application Project。

2、 将CIA_SDK.framework 拖拽到项目中。

iOS系统如何集成CIA易验证SDK?

iOS系统如何集成CIA易验证SDK?

4、 在AppDelegate中进行初始化调用。

a)       首先导入 CIA_SDK。

b)       在didFinishLaunchingWithOptions 中初始化SDK。

iOS系统如何集成CIA易验证SDK?

5、调用API

1、开始请求验证

a)       [CIA startVerificationWithPhoneNumber: callback:]

2、等待callback回调,参考回调。

3、进入验证码模式,需要校验用户输入的验证码。

a)       [CIA verifySecurityCode: callback:]

4、如果用户中途关闭了页面,需要取消当前验证

a)       [CIA cancelVerification]

API说明

API

目前SDK提供以下接口

iOS系统如何集成CIA易验证SDK?

iOS系统如何集成CIA易验证SDK?

6、初始化SDK

a)       [CIA initWithAppId: authKey:]

i.         appId:开发者后台注册的appId

ii.       authKey:开发者后台生成的authKey

2、开始验证

a)       [CIA startVerificationWithPhoneNumber: callback:]

i.         phoneNumber:需要验证的手机号码

ii.       callback:验证状态回调block,查看状态码

3、获取验证码

a)       [CIA getSecurityCode]

i.         返回值为呼入的电话号码(其中后四位为****形式),返回值的一个可能示例为:05311122****,该返回值用于向用户显示“提示语”。

显示给用户的提示语,需要开发者自行编写,可参见下图中的一个实例描述:

4、校验验证码

a)       [CIA verifySecurityCode: callback:]

i.         securityCode:用户输入的验证码

ii.       callback:验证码校验结果回调block,查看状态码

5、取消验证

a)       [CIA cancelVerification]

i.         用户中途关闭了页面,需要取消当前的验证请求,调用该方法的时候不需要判断是否有请求存在,该方法内部只在有验证请求的情况下取消验证。

6、设置验证码的超时时间

a)       [CIA setSecurityCodeTimeout:]

i.         进入单位:秒

7、设置验证码允许输入错误的次数

a)       [CIA setSecurityCodeExpiredCount:]

i.         参数:允许验证码错误的最大次数

ii.       默认值是3,连续输入错误3次该验证码失效,回调状态码104。

iOS系统如何集成CIA易验证SDK?

7、回调

1、参数

a)       code:验证状态码(参考验证状态码)

b)       msg:文字描述

c)       err:错误信息

d)       transId:本次验证的业务流水号,可用于后台查询验证状态

验证状态码

CIA.h中定义了一些宏表示验证状态码

注:请求失败(110):比如手机号码格式错误,一般需要开发者提前判断。

       请求异常(111):比如没有网络连接等,一般需要开发者提前判断。

iOS系统如何集成CIA易验证SDK?

iOS系统如何集成CIA易验证SDK?

8、后台查询接口

验证平台提供了后台查询接口,当移动端返回验证结果信息后,开发者可以在自己的业务后台再次查询验证结果,增加安全性。

接口说明

返回结果

{"transId":"业务流水号","status":"验证状态"}

iOS系统如何集成CIA易验证SDK?

iOS系统如何集成CIA易验证SDK?

声明:本网站引用、摘录或转载内容仅供网站访问者交流或参考,不代表本站立场,如存在版权或非法内容,请联系站长删除,联系邮箱:site.kefu@qq.com。
猜你喜欢