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

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

很多网友向我反馈CIA易验证（原CIA身份验证）在IOS系统中该如何快速集成，其实官网已经有详细说明，本文将从用户的实际出发，介绍IOS系统如何集成CIA易验证，希望帮助大广大的移动开发者。

SDK功能说明

1、架构设计

2、主要功能

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

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

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

3、 获取验证码：为了更好的提示用户，可以调用SDK的获取验证码（呼入的电话号码）来提示用户哪个号码将会呼入。

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

开发前准备

运行环境

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

账户申请及权限开通

1、获取方式

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

2、获取appId 和 authKey

进入开发者后台。

使用SDK开发应用

添加SDK到APP工程

1、 创建一个iOS Application Project。

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

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

a) 首先导入 CIA_SDK。

b) 在didFinishLaunchingWithOptions 中初始化SDK。

调用API

1、开始请求验证

a) [CIA startVerificationWithPhoneNumber: callback:]

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

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

a) [CIA verifySecurityCode: callback:]

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

a) [CIA cancelVerification]

API说明

类

API

目前SDK提供以下接口

1、初始化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。

回调

1、参数

a) code：验证状态码（参考验证状态码）

b) msg：文字描述

c) err：错误信息

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

验证状态码

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

注：请求失败（110）：比如手机号码格式错误，一般需要开发者提前判断。

请求异常（111）：比如没有网络连接等，一般需要开发者提前判断。

后台查询接口

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

接口说明

返回结果

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