其实每一个第三方SDK的使用都差不多，看着官方给的开发文档和Demo就能依样画瓢自己做出来。我只是希望帮助一下刚入行不久的新人。

先附上官方文档的地址：芝麻信用iOS开发文档

一、先做一些必备的工作

由于需要导入的Framework比较多，先创建一个Frameworks分组（分组和文件夹可不一样哦）

ios开发 returnKeyType iOs开发征信报告_服务器

1. 将资源bundle导入工程
     H5Service.bundle
     Poseidon.bundle

直接把下载到的这两个文件拖进Frameworks分组中


ios开发 returnKeyType iOs开发征信报告_json_02

2. 向工程中导入SDK Framework文件
     ZMCreditSDK.framework
     ZMDependUponSDK.framework
注意1：如果商户引入支付宝钱包SDK,则不需要再引入ZMBuildUponSDK.framework, 因为这样可以解决相同类库冲突的问题

注意：这两个文件导入之前一定要把他复制到你的项目中去，一般就放项目根目录下就行，跟xcodeproj文件在同一目录下


ios开发 returnKeyType iOs开发征信报告_服务器_03


这里需要选择Add Others，然后会弹出文件选择框，把刚刚复制到项目根目录下的这两个framework选进来就行了（第三步中的其他依赖库，都是系统的，直接search就行了，第三步就不贴图了）

ios开发 returnKeyType iOs开发征信报告_ios开发 returnKeyType_04


 

3. 导入其他依赖库

    SDK中依赖了其他基础库来保证正常运行，请添加如下依赖库:

MobileCoreServices.framewrok
     CFNetwork.framework
     MessageUI.framework
     EventKit.framework
     AssetsLibrary.framework
     CoreMotion.framework
     Libz.dylib （Xcode 7 之后是libz.tbd）
     SystemConfiguration.framework
     CoreTelephony.framework

二、开始使用芝麻信用SDK

自己先把流程走一遍，一切都会变的很容易。（流程见下图）

ios开发 returnKeyType iOs开发征信报告_服务器_05

首先，在AppDelegate里面来注册应用：



    1. [[ALCreditService sharedService] resgisterApp];



    当然，在AppDelegate中和请求芝麻信用分数的Controller中肯定也都需要引入头文件 


      1. #import <ZMCreditSDK/ALCreditService.h>


      接下来就是正式使用芝麻信用SDK了

      ①我们把用户的信息（姓名、手机号、身份证号码）通过APP传给公司的服务器（这一步其实基本不属于芝麻信用的使用范畴，现在哪个APP获取不到用户的个人信息？！我们这里其实只传了姓名和身份证号码，其实有了身份证号码，芝麻信用自然就能锁定到那个唯一的人）只要能够获取到姓名和身份证号码，服务器那边就能传给我们一个经过加密的param和一个经过加密的sign

      注意2：界面跳转是基于navigationController的push功能，并且使用的是系统的nav bar，如果商户端有对nav bar作自定义，请在调用SDK之前，进行nav bar的调整。


        1. - (void)buttonAction:(UIButton *)button {  
2. // ①把用户数据传给服务器，即传入参数（字典）  
3. //（如果后台从别的页面已经获取到用户的这些数据了，此处也可以不传参数，这就看你跟后台怎么商量了；IDCardNumber和userName是后台给你的，不是固定死的）  
4. NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:@"18位身份证号码", @"IDCardNumber", @"用户姓名", @"userName", nil nil];  
5. // 创建网络请求管理对象  
6. AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];  
7. // 申明返回的结果是json类型  
8. .responseSerializer = [AFJSONResponseSerializer serializer];  
9. // 申明请求的数据是json类型  
10. .requestSerializer = [AFJSONRequestSerializer serializer];  
11. // 如果报接受类型不一致请替换一致text/html或别的  
12. .responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"text/html", nil nil];  
13.       
14.  POST:URL parameters:dict constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {  
15.           
16.  progress:^(NSProgress * _Nonnull uploadProgress) {  
17.           
18.  success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {  
19.           
20. // ②芝麻信用SDK提供的方法，就是这么简单，就一行代码，搞定。（APP ID由公司给你，这个是固定的，写死就行）  
21. // ②这里只要传三个参数就行，app id、sign、params，芝麻信用会返回给我们一个字典，在result中  
22.  sharedService] queryUserAuthReq:@"APP ID" sign:responseObject[@"sign"] params:responseObject[@"param"] extParams:nil selector:@selector(result:) target:self];  
23.           
24.  failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {  
25.           
26.     }];  
27. }



        ②根据SDK给的方法，把第二步获取到的这两个参数和APP ID传进去，这些就被传到芝麻信用的服务器，然后会返回给我们授权token，字段名也是sign和params 



        1. // ②芝麻信用SDK提供的方法，就是这么简单，就一行代码，搞定。（APP ID由公司给你，这个是固定的，写死就行）  
2. // ②这里只要传三个参数就行，app id、sign、params，芝麻信用会返回给我们一个字典，在result中  
3. [[ALCreditService sharedService] queryUserAuthReq:@"APP ID" sign:responseObject[@"sign"] params:responseObject[@"param"] extParams:nil selector:@selector(result:) target:self];

        这一步的代码不用复制，就在第一步的AFN网络请求成功后写这一行代码（上面第一步中有）


        ③我们再把params提交给公司的服务器，然后服务器就能通过这个token获取到用户的芝麻信用分数，最后把分数返回给我们就好了。（我们这里只传了params就能请求的到芝麻信用分数）



        1. - (void)result:(NSMutableDictionary*)dic{  
2. // ③从第二步中芝麻信用返回给我们的字典就是这的dic，你可以试着打印看一下  
3. // ③把params提交给服务器，服务器就能把芝麻信用分数返回给我们了，这里dict的key：params也是后台给你的，不是固定的。  
4. NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:dic[@"params"], @"params", nil nil];  
5. // 创建网络请求管理对象  
6. AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];  
7. // 申明返回的结果是json类型  
8. .responseSerializer = [AFJSONResponseSerializer serializer];  
9. // 申明请求的数据是json类型  
10. .requestSerializer = [AFJSONRequestSerializer serializer];  
11. // 如果报接受类型不一致请替换一致text/html或别的  
12. .responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"text/html", nil nil];  
13.       
14.  POST:URL parameters:dict constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {  
15.           
16.  progress:^(NSProgress * _Nonnull uploadProgress) {  
17.           
18.  success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {  
19.           
20. // 看看这里是不是打印出了你想要的芝麻分数了呢  
21. @"%@", responseObject);  
22.           
23.  failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {  
24.           
25.     }];    
26. }

        注意3：由于sdk里面有用到c编译,请把调用queryUserAuthReq的controller后缀名改成.mm