智能验证SDK为开发者提供一个完全透明、方便、高效的验证服务，智能验证平台聚合了稳定的短信、语音验证码服务，开发者无需再开发自己的短信通道、语音网关，而且基于公共云的强大服务，使得验证能逐步避免下发短信、语音手机号的方式验证，从而更快速，更准确快速验证，解决APP验证的验证难题、提升产品体验。

本文档主要阅读对象为开发人员，包括客户端和服务端。

登录www.ucpaas.com官网，注册（已经有账号的跳过）

UCPaas运营人员审核后，可执行下一步创建应用

登录后管理中心，点击“应用管理”—》“应用列表”—》“创建应用”

配置项目:

指定智能验证配置项：

每个应用下可创建一个（只能有一个）智能验证短信的模板

创建一个iPhone工程需要在Mac系统下面安装Xcode的软件，Xcode安装完成后可以在桌面的快速启动栏中的“Launchpad”中或者应用程序中找到一个图标看到后单击或者双击即可打开软件，Xcode版本最小需要4.2。

打开Xcode后的界面可以看到几个选项，创建工程需要选择“Create a newXcode project”,如下图所示：

也可以根据菜单创建工程，依次选择XCode菜单栏中的FiLe→New→Project，如下图所示：

选择完后弹出的界面中选择左边的“iOS”下面的“Application”,然后选择右边的“SingLeViewAppLication”进行双击或者点击右下角“Next”, 如下图所示：

在完成后弹出的界面中的“ProductName”中填写你的工程名，如下图所示:

添加完成后点击右下角的”Next”，在弹出的对话框中选择你需要把工程放置的位置。这样一个工程就初步的创建完成。

创建完成工程后，把SDK包里面的ucssdk文件夹拷贝到新创建的工程路径下面，然后在工程目录结构中，右键选择Add Files to “UCSVoipDemo”(工程名称，在弹出的对话框中选择新创建的工程文件夹下的sdk这个文件夹，即前面拷贝的文件夹)。或者将这个文件夹拖入XCode 工程目录结构中， 在弹出的界面中勾选Copy items into destination group’s folder(ifneeded),并确保Add To Targets勾选相应的target。 相应的操作请看下图中所示：

• 添加依赖框架(Frameworks) UCSSDK的实现，依赖了一些系统框架，在开发应用时，要在工程里加入这些框架。开发者首先点击工程右边的工程名,然后在工程名右边 依次选择TARGETS→BuiLd Phases→Link Binary With Libraries,展开LinkBinary With Libraries后点击展开后下面的“+“来添加下面的依赖项:

添加步骤如图所示:

• 编译器设置 在xcode5.1环境下，首先点击工程右边的工程名,然后在工程名右边依次选择TARGETS、Build Settings LLVM 5.1- Language C++”中的”C++ Standard Library”.存后面的选择框中选择libstdc++(GNU C++ standard Library)”选项，如果默认是则不需要修改。步骤如下图所示：

• 编译器链接设置 在xcode5.1环境下，首先点击工程右边的工程名,然后在工程名右边依次选择TARGETS、Build Settings Linking中的Other Linker Flags. 中填入-ObjC。 如下图所示：

介绍代码的实现过程，也可参考Demo的代码实现。

当用户手机未通过智能验证时，需要下发短信/语音验证码的方式验证手机号的有效性。

流程说明：
1) 请求1的流程是发生在开发者自己的客户端和服务器，主要检测手机是否已经注册，如果未注册，则返回签名作为请求2中调用智能验证SDK的参数；

2) 请求2 执行下发验证码的操作，具体接口参数详见“接口调用“中的”请求验证“接口说明；

3) 请求3为提交验证码验证结果，检查用户的手机有效性；

4) 异步通知结果详见“5 服务器异步通知说明”；

流程说明：
1) 请求1的流程是发生在开发者自己的客户端和服务器，主要检测手机是否已经注册，如果未注册，则返回签名作为请求2中调用智能验证SDK的参数；

2) 请求2 执行下发验证码的操作，具体接口参数详见“接口调用“中的”请求验证“接口说明；

3) 请求3为提交验证码验证结果，检查用户的手机有效性；

4) 异步通知结果详见“5 服务器异步通知说明”；

/**
 * 初始化实例及代理设置
 */
- (UCSVerifyService *)initWithDelegate:(id)delegate;

用户在收到短信或语音下发的验证码后，输入提交验证，APP调用SDK来完成验证码的校验

-(void)getVerificationCode:(NSString *)sid withAppid:(NSString *)appid withAppName:(NSString *)appName withCodetype:(int)codetype withPhone:(NSString *)phone withSeconds:(int)seconds withBusiness:(int)business withSign:(NSString *)sign;

参数说明：

//获取验证码
 
-(void)requestCode
{ //@"d5580902cab4d8853b06644a55ef720a" withAppid:@"6f06242e1fea4c699dcc9124ad4421a5"
    [self.ucsCallService getVerificationCode:@"4c1990a5c1ad2674bc94bc39a6fd0699" withAppid:@"efb7e1de9da649fa83881afea2841cd7" withAppName:@"测试DEMO" withCodetype:1 withPhone:self.txt_codePhone.text withSeconds:60 withBusiness:1 withSign:signString];
 
}

用户在收到短信或语音下发的验证码后，输入提交验证，APP调用SDK来完成验证码的校验

-(void)doVerificationCode:(NSString *)sid withAppid:(NSString *)appid withPhone:(NSString *)phone withVerifycode:(NSString *)verifycode;

参数说明：

//点击“下一步” 验证
 
- (IBAction)bt_Verfy:(id)sender {
    [self.txt_codePhone resignFirstResponder];
    [self.txt_code resignFirstResponder];
 
    if (self.txt_code.text.length==0) {
        [self showtips:@"请输入验证码"];
        return;
    }
 
    [self.ucsCallService doVerificationCode:@"4c1990a5c1ad2674bc94bc39a6fd0699" withAppid:@"efb7e1de9da649fa83881afea2841cd7" withPhone:self.txt_codePhone.text withVerifycode:self.txt_code.text];
 
}

当用户手机号在智能验证平台通过验证后，在返回SDK的HTTP结果时，执行异步线程通知开发者服务器的成功验证结果。开发者服务器在收到通知后，请注意做签名校验防止恶意请求。

-表- 回调验证成功参数

http://www.xxx.com/callback/?appid=00e1d21234567891024e1a123456cfa3&phone=13800038000&sign=9d801affd5eadd325b8217430ec809e6

签名字符串: (开发者主账号+应用ID+手机号+应用配置的密钥)

例如：
开发者主账号：0316894c88d389035113e4bf01c30e2f
应用ID：00e1d21234567891024e1a123456cfa3
手机号：13800038000
秘钥：private_key
MD5(0316894c88d389035113e4bf01c30e2f00e1d21234567891024e1a123456cfa313800038000private_key)
MD5后sign = 9d801affd5eadd325b8217430ec809e6 (注意是小写)

开发者服务器收到请求后返回： {“result”:”success”}