集成要求

环境要求

条目	说明
兼容版本	iOS9.0及以上
支持架构	armv7, arm64, x86_64

集成步骤

安装(CocoaPods)

需要接入设备指纹，在 Podfile 文件中对应 target 中新增

pod 'TrustDecisionPro', '5.3.1.1'

若不需要接入设备指纹，在 Podfile 文件中对应 target 中新增

  pod 'TrustDecisionPro/TDMobRisk', '5.3.1.1'
  pod 'TrustDecisionPro/TDCorePlugin', '5.3.1.1'

在 Podfile 文件中对应 target 中新增

pod 'TrustDecisionAPISign', '1.1.3'

在 Podfile 所在文件夹中执行 pod install --repo-update 命令 (M1系列mac电脑需要执行 arch -x86_64 pod install --repo-update 命令)

引入头文件

在调用的位置引入头文件

#import <TDMobRisk/TDMobRisk.h>

import TDMobRisk

接口签名

方法定义

TDAPISignResult (*sign)(NSString *path);

结构体定义

typedef struct _TDAPISignResult{
    // 签名结果
    const char* sign;
    // 状态码
    int code;
    // 错误信息
    const char* msg;
}TDAPISignResult;

最佳实践

待保护的API形式如：https://cn.apitd.net/de/v1，则可以参考下面方式使用SDK。

NSString *path = @"de/v1";
TDMobRiskManager_t *manager = [TDMobRiskManager sharedManager];
TDAPISignResult result = manager->sign(path);
// 加签成功
if(result.code == 0){
    // 获取签名并使用
    NSString* signString = [NSString stringWithUTF8String:result.sign];
}else{
    // 获取状态码
    int code = result.code;
    // 获取错误信息
    NSString* errMsgString = [NSString stringWithUTF8String:result.msg];
    // 继续业务逻辑，此处应用可以基于业务来做异常处理。
}

let path = "de/v1"
let manager = TDMobRiskManager.sharedManager()
let result = manager?.pointee.sign(path)
// 加签成功
if result?.code == 0 {
    // 获取签名并使用
    let signString = result?.sign
}else {
    // 获取状态码
    let code = result?.code
    // 获取错误信息
    let errMsgString = result?.msg;
    // 继续业务逻辑，此处签名可以用空字符替代
}

状态检查

通过加签返回的状态码进行判定。

TDAPISignResult.code==0

状态码说明

错误码	错误信息	处理方式
0	sign 正常生成返回	/
2000	path为空	请设置path参数
22xx	SDK内部异常	一般不会出现，如果出现，联系TD分析
3001	SDK内部异常	一般不会出现，如果出现，联系TD分析
3005	SDK内部异常	一般不会出现，如果出现，联系TD分析