快速开始

在开始之前，请确保您已经拥有 Geelab 控制台访问权限，并已确认本次接入的平台与服务端链路。

前置要求

Geelab 控制台访问权限
已确定接入平台：Web、Android 或 iOS
已规划业务服务端接收 Token 并查询最终结果的链路

地域规划

开始接入前，建议先阅读地域选择，确保应用创建、服务端配置与合规要求保持一致。

地域	适用场景	接入建议
🌏 全球	亚太或全球分布业务	默认优先选项
🇪🇺 欧洲	欧盟用户为主、强调 GDPR 合规	独立应用与密钥
🇺🇸 北美	北美用户为主	独立应用与密钥

步骤 1：创建应用并获取凭证

登录 Geelab 控制台
创建新的设备指纹应用，并选择合适的地域
获取 appId
在服务端保存对应的 private_key

请妥善保管 private_key，不要在客户端代码、前端构建产物或移动端资源中暴露。

步骤 2：完成客户端 SDK 接入

按业务平台选择对应的接入方式：

web-example.js

loadGeelabGuard({
  appId: 'YOUR_APP_ID',
  protocol: 'https://'
})
  .then((instance) => instance.get())
  .then((result) => {
    console.log(result.data.respondedGeeToken || result.data.geeToken);
  });

查看 Web 集成指南了解完整初始化参数与返回结构。

查看 Android 集成指南了解 SDK 初始化、Token 获取与错误码说明。

查看 iOS 集成指南了解注册方式、respondedGeeToken 获取与隐私要求。

步骤 3：在业务请求时提交 Token

客户端接入完成后，在注册、登录、下单等关键请求中提交以下信息到业务服务端：

respondedGeeToken 或 geeToken
业务流水号、用户 ID、订单号等上下文
平台信息与业务场景标识

Geelab 设备指纹服务端暂时不支持直接用 geeToken 查询。

步骤 4：服务端查询最终结果

服务端根据设备指纹服务链路获取可用于查询的 gee_token，再调用 fp_query 获取最终结果：

request.json

{
  "gee_token": "server-returned-gee-token",
  "private_key": "YOUR_PRIVATE_KEY",
  "ts": 1712345678
}

可获取的核心字段包括：

fp
risk_code
risk_label
client_ip
client_type
access_list

fp_query 只接受设备指纹服务链路返回的 gee_token，不要把客户端原始 token 直接作为 fp_query 的输入。