Genius Scan 数据 API：云文档、页面与账户字段

The Grizzly Labs · 效率工具

Genius Scan 是 The Grizzly Labs 的拍照转 PDF 扫描应用，带 Genius Cloud 同步。在 POST /v1/accounts/login 之后，客户端通过 GET /v1/vault/items 列出云库文档（游标查询 usn），水合页面文件，并在 GET /v1/storage/tokens 签发短期对象存储访问凭证。

同步是增量且感知回收站的：/v1/vault/items/{itemId} 水合单个文档，含 tags、parent 文件夹与嵌套页面，页面的 quadrangle 与 post_processing_type 描述裁剪与滤镜；对同一路径的 DELETE 通过 deleted_at 软删除，除非 permanently=true 将其彻底清除。这些存储凭证——access_key_id、session_token 及其过期时间——才是真正搬运页面 JPEG 的关键，对象按页面 uid 与文件类型为键。账户管理在 /v1/accounts/profile，修改邮箱需要 current_password；OCR 本身从不离开设备。

Genius Scan 是 The Grizzly Labs 的拍照转 PDF 扫描应用，自带 Genius Cloud 云库。邮箱/密码登录后获得 Bearer 令牌与用户 uid、email，随后按 usn 增量同步文档（name、tags、pages、parent）与页面文件（type、md5、format）；短期对象存储凭证（access_key_id、session_token、expiration）按页面 uid 收发页面 JPEG。账户调用可读取与更新邮箱，OCR 在设备端运行。

应用截图

API 端点一览

注册 Genius Cloud 会话
POST /v1/accounts/register opendata
创建 Genius Cloud 账户，返回已登录用户（uid、email）及文档同步与账户调用所用的 Bearer 令牌。
认证方式：无。请求体携带 email 与 password。响应令牌在后续 Genius Cloud 调用中以 Authorization: Bearer 请求头发送。
- email
- password
- user
- uid
- token
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/accounts/register HTTP/1.1
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "hunter2-example"
}
```
```
{
  "user": {
    "uid": "usr_8f3c1d2e7a9b",
    "email": "[email protected]"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的云账户注册流程重建
- 字段集镜像注册表单（email、password）及其返回的会话
登录 Genius Cloud
POST /v1/accounts/login opendata
认证已有 Genius Cloud 账户，返回用户对象与 Bearer 令牌，同步客户端会将其附加到后续调用。
认证方式：无。请求体携带 email 与 password。响应令牌在后续调用中以 Authorization: Bearer 请求头发送。
- email
- password
- user
- uid
- token
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/accounts/login HTTP/1.1
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "hunter2-example"
}
```
```
{
  "user": {
    "uid": "usr_8f3c1d2e7a9b",
    "email": "[email protected]"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的云登录界面重建
按用户 uid 重连会话
POST /v1/accounts/reconnect opendata
当客户端已知账户 uid 时重新打开 Genius Cloud 会话，返回新的 Bearer 令牌与用户对象。
认证方式：无。请求体携带 uid 与 password（而非 email）。响应令牌在后续调用中以 Authorization: Bearer 请求头发送。
- uid
- password
- user
- email
- token
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/accounts/reconnect HTTP/1.1
Content-Type: application/json

{
  "uid": "usr_8f3c1d2e7a9b",
  "password": "hunter2-example"
}
```
```
{
  "user": {
    "uid": "usr_8f3c1d2e7a9b",
    "email": "[email protected]"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据安装已知晓账户 ID 时使用的会话恢复路径重建
更新会话设备令牌
PUT /v1/accounts/session opendata
在打开的 Genius Cloud 会话上注册 device_token，让同步与账户通知能定位到此安装。
认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。
- device_token
- user
- uid
- email
- token
依据应用界面重构的示意示例，并非实时抓包。
```
PUT /v1/accounts/session HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json

{
  "device_token": "fcm-device-token-example"
}
```
```
{
  "user": {
    "uid": "usr_8f3c1d2e7a9b",
    "email": "[email protected]"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据登录后的推送通知注册步骤重建

列出自指定 USN 以来的云文档

GET /v1/vault/items opendata

增量同步 Genius Cloud 云库：返回查询 usn 之后变更的条目，含页面文件与 remaining-count 标记，客户端据此判断是否需要再次拉取。

认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。

usn
remaining-count
uid
name
tags
pages
created_at
updated_at
deleted_at
document_type
parent
order
format
quadrangle
post_processing_type
distortion_correction_enabled
files
type
md5
version

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/vault/items?usn=1842&remaining-count=true HTTP/1.1
Authorization: Bearer <token>

[
  {
    "uid": "doc_a1b2c3d4",
    "name": "Passport scan",
    "tags": ["id", "travel"],
    "pages": [{
      "uid": "page_9f0e",
      "order": 0,
      "format": "jpeg",
      "quadrangle": "0,0,1,0,1,1,0,1",
      "post_processing_type": "color",
      "distortion_correction_enabled": true,
      "files": [{
        "type": "original",
        "md5": "d41d8cd98f00b204e9800998ecf8427e",
        "version": "1",
        "format": "jpeg"
      }],
      "created_at": "2026-09-20T14:02:11Z",
      "updated_at": "2026-09-20T14:02:18Z"
    }],
    "created_at": "2026-09-20T14:02:11Z",
    "updated_at": "2026-09-20T14:02:18Z",
    "deleted_at": null,
    "usn": 1843,
    "document_type": "document",
    "parent": null
  }
]

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据驱动应用文档库视图的文档列表同步重建
字段集镜像云库文档卡片及其页面描述符

获取单个云文档

GET /v1/vault/items/{itemId} opendata

按 ID 水合单个 Genius Cloud 云库条目（文档或文件夹），含嵌套页面与扫描器存入对象存储的原始页面文件。

认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。

itemId
uid
name
tags
pages
created_at
updated_at
deleted_at
usn
document_type
parent
files
type
md5
format

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/vault/items/doc_a1b2c3d4 HTTP/1.1
Authorization: Bearer <token>

{
  "uid": "doc_a1b2c3d4",
  "name": "Passport scan",
  "tags": ["id", "travel"],
  "pages": [{
    "uid": "page_9f0e",
    "order": 0,
    "format": "jpeg",
    "quadrangle": "0,0,1,0,1,1,0,1",
    "post_processing_type": "color",
    "distortion_correction_enabled": true,
    "files": [{
      "type": "original",
      "md5": "d41d8cd98f00b204e9800998ecf8427e",
      "version": "1",
      "format": "jpeg"
    }],
    "created_at": "2026-09-20T14:02:11Z",
    "updated_at": "2026-09-20T14:02:18Z"
  }],
  "created_at": "2026-09-20T14:02:11Z",
  "updated_at": "2026-09-20T14:02:18Z",
  "deleted_at": null,
  "usn": 1843,
  "document_type": "document",
  "parent": null
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据文档详情页及其页面文件清单重建

更新云文档

PUT /v1/vault/items/{itemId} opendata

把文档元数据与页面描述符（name、tags、parent 文件夹、页面文件）写回 Genius Cloud，并返回带新 usn 的更新条目。

认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。

itemId
uid
name
tags
pages
usn
document_type
parent
created_at
updated_at
deleted_at

依据应用界面重构的示意示例，并非实时抓包。

PUT /v1/vault/items/doc_a1b2c3d4 HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json

{
  "uid": "doc_a1b2c3d4",
  "name": "Passport scan (front)",
  "tags": ["id", "kyc"],
  "pages": [{
    "uid": "page_9f0e",
    "order": 0,
    "format": "jpeg",
    "quadrangle": "0,0,1,0,1,1,0,1",
    "post_processing_type": "color",
    "distortion_correction_enabled": true,
    "files": [{
      "type": "original",
      "md5": "d41d8cd98f00b204e9800998ecf8427e",
      "version": "1",
      "format": "jpeg"
    }],
    "created_at": "2026-09-20T14:02:11Z",
    "updated_at": "2026-09-27T10:15:00Z"
  }],
  "created_at": "2026-09-20T14:02:11Z",
  "updated_at": "2026-09-27T10:15:00Z",
  "deleted_at": null,
  "usn": 1843,
  "document_type": "document",
  "parent": null
}

{
  "uid": "doc_a1b2c3d4",
  "name": "Passport scan (front)",
  "tags": ["id", "kyc"],
  "pages": [{
    "uid": "page_9f0e",
    "order": 0,
    "format": "jpeg",
    "quadrangle": "0,0,1,0,1,1,0,1",
    "post_processing_type": "color",
    "distortion_correction_enabled": true,
    "files": [{
      "type": "original",
      "md5": "d41d8cd98f00b204e9800998ecf8427e",
      "version": "1",
      "format": "jpeg"
    }],
    "created_at": "2026-09-20T14:02:11Z",
    "updated_at": "2026-09-27T10:15:00Z"
  }],
  "created_at": "2026-09-20T14:02:11Z",
  "updated_at": "2026-09-27T10:15:00Z",
  "deleted_at": null,
  "usn": 1901,
  "document_type": "document",
  "parent": null
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据文档编辑器中的重命名、打标签与移动操作重建

删除云文档
DELETE /v1/vault/items/{itemId} opendata
移除 Genius Cloud 云库条目。查询 permanently=false 为软删除（设置 deleted_at）；permanently=true 则彻底清除云库条目。
认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。
- itemId
- permanently
- deleted_at
- uid
依据应用界面重构的示意示例，并非实时抓包。
```
DELETE /v1/vault/items/doc_a1b2c3d4?permanently=false HTTP/1.1
Authorization: Bearer <token>
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据含软删除与彻底删除选项的文档回收流程重建
刷新页面图像的对象存储凭证
GET /v1/storage/tokens opendata
签发短期对象存储会话凭证，让扫描器按页面 uid 与文件类型上传、下载页面图像对象（默认 jpeg；original 文件类型为必需）。
认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。
- access_key_id
- secret_access_key
- session_token
- expiration
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/storage/tokens HTTP/1.1
Authorization: Bearer <token>
```
```
{
  "access_key_id": "ASIAEXAMPLEKEYID",
  "secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "session_token": "FwoGZXIvYXdzEJr//////////wEaEXAMPLE",
  "expiration": "2026-09-27T13:05:00Z"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用与对象存储之间收发页面图像的交接环节重建
获取 Genius Cloud 用户
GET /v1/accounts/profile osint
返回已登录 Genius Cloud 身份：账户页使用的 uid 与 email。
认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。
- uid
- email
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/accounts/profile HTTP/1.1
Authorization: Bearer <token>
```
```
{
  "uid": "usr_8f3c1d2e7a9b",
  "email": "[email protected]"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据展示已登录身份的账户页重建
更新用户邮箱
PUT /v1/accounts/profile opendata
确认 current_password 后修改 Genius Cloud 登录邮箱，并返回更新后的用户对象。
认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。请求体要求 current_password。
- email
- current_password
- uid
依据应用界面重构的示意示例，并非实时抓包。
```
PUT /v1/accounts/profile HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json

{
  "email": "[email protected]",
  "current_password": "hunter2-example"
}
```
```
{
  "uid": "usr_8f3c1d2e7a9b",
  "email": "[email protected]"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据带密码确认的修改邮箱表单重建
删除 Genius Cloud 用户
DELETE /v1/accounts/profile opendata
用户确认密码后永久关闭 Genius Cloud 账户；供账户注销流程使用。
认证方式： Authorization: Bearer 令牌，来自 POST /v1/accounts/login。DELETE 请求体携带账户密码。
- password
- uid
- email
依据应用界面重构的示意示例，并非实时抓包。
```
DELETE /v1/accounts/profile HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json

{
  "password": "hunter2-example"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据带密码确认的关闭账户流程重建
刷新 Genius Scan SDK 许可证密钥
GET /v1/licensing/keys/{keyId} opendata
刷新设备端扫描许可证。查询参数标识安装；响应的 key 与 expiration_date 决定采集功能是否可用。
认证方式：无。设备与 SDK 身份以查询参数传递：device_id、sdk_version、framework、os、os_version，可选 app_version、integration_mode 与 key_refresh。
- keyId
- device_id
- sdk_version
- framework
- os
- os_version
- app_version
- integration_mode
- key_refresh
- key
- expiration_date
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/licensing/keys/GS-BASE-LICENSE-KEY?device_id=3a7c9e12f04b8d11&sdk_version=5.12.0&framework=android&os=android&os_version=14&app_version=7.43.0&integration_mode=app&key_refresh=1 HTTP/1.1
```
```
{
  "key": "GS-REFRESHED-LICENSE-KEY",
  "expiration_date": "2027-03-01T00:00:00Z"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用在支持的设备上执行的扫描许可证刷新重建

数据类别

文档
页面
账户
会话
凭证
身份

数据使用场景与案例

从扫描证件构建 KYC 档案
入职审核团队可拉取 Genius Cloud 中标记为身份扫描的文档，遍历嵌套页面与原始 jpeg 文件，并存储 uid、name、tags 与 usn，无需重拍护照或证件即可重建案件档案。
文档云库增量备份
归档作业可用 usn 游标与 remaining-count 标记分页拉取文档列表，再用签发的 access_key_id、secret_access_key、session_token 与 expiration，把以 pageUid-fileType.format 为键的页面文件复制到长期归档。
账户生命周期与注销
隐私工作流可从已登录用户读取 uid 与 email，凭 current_password 更换邮箱，并在客户要求离开 Genius Cloud 时发起密码确认的账户删除。
采集设备群的扫描许可证健康监控
运维可按 device_id 与 app_version 监控 SDK 许可证刷新，在现场设备的采集、畸变校正与 PDF 导出停止工作之前提前看到 expiration_date。

常见问题

Genius Scan 如何认证云同步？

注册与登录把 email 与 password 提交到 /v1/accounts/register 和 /v1/accounts/login。响应令牌在后续云库、存储令牌与资料调用中以 Authorization: Bearer 请求头发送。另有重连变体把账户 uid 加密码提交到 /v1/accounts/reconnect。

哪些字段描述一个已同步的 Genius Scan 文档？

每个云库条目含 uid、name、tags、pages、usn、document_type（document 或 folder）、parent、created_at、updated_at 与 deleted_at。页面另有 order、format、quadrangle、post_processing_type、distortion_correction_enabled 与 files（type、md5、version、format）。

扫描的页面图像存在哪里？

GET /v1/storage/tokens 返回 access_key_id、secret_access_key、session_token 与 expiration。页面图像对象按页面 uid 与文件类型为键；original 是必需的文件类型，jpeg 是默认格式。

Genius Scan 会把扫描件发到云端 OCR API 吗？

不会。文字识别在设备上运行。网络数据面是云端文档同步、/v1/accounts/profile 的用户账户、页面文件的短期存储令牌，以及 /v1/licensing/keys/{keyId} 的扫描许可证刷新。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Genius Scan 数据 API：云文档、页面与账户字段

应用截图

API 端点一览

注册 Genius Cloud 会话

登录 Genius Cloud

按用户 uid 重连会话

更新会话设备令牌

列出自指定 USN 以来的云文档

获取单个云文档

更新云文档

删除云文档

刷新页面图像的对象存储凭证

获取 Genius Cloud 用户

更新用户邮箱

删除 Genius Cloud 用户

刷新 Genius Scan SDK 许可证密钥

数据类别

数据使用场景与案例

从扫描证件构建 KYC 档案

文档云库增量备份

账户生命周期与注销

采集设备群的扫描许可证健康监控

常见问题

更多效率工具类应用

All Languages Translator

PDF Scanner app - TapScanner

Simple Scan - PDF Scanner App

Vault - Hide Pics, App Lock

相关主题

需要集成这个 App 的数据 API？

Genius Scan 数据 API：云文档、页面与账户字段

应用截图

API 端点一览

注册 Genius Cloud 会话

登录 Genius Cloud

按用户 uid 重连会话

更新会话设备令牌

列出自指定 USN 以来的云文档

获取单个云文档

更新云文档

删除云文档

刷新页面图像的对象存储凭证

获取 Genius Cloud 用户

更新用户邮箱

删除 Genius Cloud 用户

刷新 Genius Scan SDK 许可证密钥

数据类别

数据使用场景与案例

从扫描证件构建 KYC 档案

文档云库增量备份

账户生命周期与注销

采集设备群的扫描许可证健康监控

常见问题

相关应用

更多效率工具类应用

All Languages Translator

PDF Scanner app - TapScanner

Simple Scan - PDF Scanner App

Vault - Hide Pics, App Lock

相关主题

需要集成这个 App 的数据 API？