接入指南

设备指纹接入分为两段：客户端负责采集与上报，服务端负责最终查询与业务决策。建议先打通最短链路，再逐步完善策略。

平台选择

适用于 H5、PC Web 和内嵌 WebView 场景

适用于 Android 原生客户端集成

适用于 iOS 原生客户端集成

查看 fp_query 请求结构、返回字段与错误码

在控制台创建应用，获取 appId，并按区域、业务或环境规划应用隔离方式。

如果不同区域或业务线需要独立风控策略，建议从一开始就拆分多个应用，避免后续迁移成本过高。

在 Web、Android 或 iOS 侧初始化 SDK，并在关键业务请求中获取 respondedGeeToken 或 geeToken。

将 Token 与业务流水号、用户 ID、订单号、场景标识等信息一并提交给业务服务端，方便后续策略联动。

服务端基于设备指纹服务链路调用 fp_query，获取 fp、risk_code、risk_label 等最终结果。

不要在客户端保存 private_key，也不要把客户端原始 token 直接当作 fp_query 的输入。

在测试环境同时验证在线与离线 Token 路径，再将风险结果接入生产策略。