快速开始

SDK 快速接入

下载对应语言 SDK，填入应用标识、应用密钥、签名参数后即可发起验证请求。

调用地址

生产环境与测试环境推荐分离，建议统一通过网关地址转发到光年验证 API 服务。

两种卡密

支持单码卡密模式和用户模式。前者以卡密为主键，后者以用户身份凭据为主键。

对接流程

初始化 SDK → 请求登录接口 → 保存会话凭据 → 周期心跳验证 → 退出时销毁会话。

单码卡密模式

客户端提交卡密和设备指纹，服务端返回状态、过期时间和授权能力列表。

用户模式

客户端提交账号身份信息，支持用户注册、登录、设备绑定和多端管理。

通用参数

占位说明：所有接口通常携带 app_id、timestamp、nonce、sign、payload 字段。

通用响应

{
  "code": 200,
  "message": "success",
  "request_id": "demo-uuid",
  "data": {}
}

下一步

查看接口文档、SDK 接入和示例工程，按你的业务模型完成参数映射与验签集成。