应用通过调用Device Security Kit的getDeviceToken接口获取到DeviceToken,应用的服务器使用DeviceToken到Device Security服务器查询和管理应用在该设备的使用状态。
应用可以根据Device Security服务器返回的使用状态,判断应用是否在该设备上首次安装,或在该设备上用户是否已获取了优惠券等,以支撑业务进行新用户营销活动。
流程说明:
以下是DeviceVerify相关接口,包括ArkTS API和REST API。
接口名 | 描述 |
|---|---|
获取本设备的DeviceToken | |
验证deviceToken | |
查询设备标记状态 | |
更新设备标记状态 | |
删除设备标记状态 |
当getDeviceToken接口由于网络不稳定或其他原因无法获取到DeviceToken时,应用需要考虑异常处理方案,避免出现应用依赖DeviceToken的基本功能不可用。例如应用重新调用getDeviceToken接口或采用其他风控因子进行判断。
import { deviceCertificate } from '@kit.DeviceSecurityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';const TAG = "DeviceCertificateJsTest";
// 请求deviceToken,并处理结果
try {
deviceCertificate.getDeviceToken().then((token) => {
hilog.info(0x0000, TAG, 'Succeeded in executing getDeviceToken');
// 开发者处理deviceToken
}).catch((err: BusinessError) => {
hilog.error(0x0000, TAG, 'getDeviceToken failed! %{public}d %{public}s', err.code, err.message);
});
} catch(err) {
let error: BusinessError = err as BusinessError;
hilog.error(0x0000, TAG, 'getDeviceToken failed! %{public}d %{public}s', error.code, error.message);
}
deviceToken由Device Security Kit加密生成,每次调用生成Token均不一样,有效期1小时。