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

The Grizzly Labs · 效率工具

Genius Scan - PDF Scanner 是巴黎工作室 The Grizzly Labs 出品的口袋文档扫描应用，这家公司还把同一套采集引擎以 Genius Scan SDK 的形式授权给其他应用。拍摄界面会自动识别纸张边缘并裁切、校正透视畸变，再套用彩色或黑白增强滤镜；批量模式能把多张连拍合成一份多页 PDF，分享前可调整页序、重命名并添加标签，设备端文字识别则让扫描结果可以检索。文档库用文件夹和标签整理扫描件，可选的 Genius Cloud 账户能在用户的多台设备间同步整个文档库，账户页面还支持更换登录邮箱或注销账户。用户用它在手机上直接扫描收据、发票、合同、身份证和护照，省去平板扫描仪；在移动文档扫描工具品类中，它与 Adobe Scan、CamScanner 同场竞争，此处收录的是美国商店版本。

同步后的扫描件以条目形式落入 Genius Cloud 云库，以 uid 为键，带有 name、tags 列表、区分文档与文件夹的 document_type、用来还原文件夹树的 parent 指针，以及 created_at、updated_at、deleted_at 时间戳。usn 更新序号让客户端只拉取上次同步之后的变更，remaining-count 标志说明是否还要再拉一轮；被删除的条目会保留 deleted_at 标记，直到被永久清除。条目内的 pages 保留 order 页序与采集设置——quadrangle 裁切四角、post_processing_type 滤镜，以及是否开启 distortion_correction_enabled——每页再按 type、md5、version、format 列出其 files，原始文件始终必备。页面图像本身存放在对象存储中，按页面 uid 与文件类型分键，通过短期有效的 access_key_id、secret_access_key、session_token 与 expiration 凭证访问。

云库之外是账户与授权层：已登录身份以 uid 和 email 呈现，推送用的 device_token 绑定在会话上，更换邮箱需以 current_password 确认；扫描授权本身是一枚带 expiration_date 的 key，按 device_id、sdk_version、framework、os_version 与 app_version 刷新。

入职审核团队据此按 uid、name 与 tags 从护照和身份证扫描件重建 KYC 档案，无需让客户重新拍摄；档案团队借助 usn 游标做云库增量备份，把页面文件复制进长期归档；隐私工作流读取已登录用户、轮换登录邮箱，并在客户离开 Genius Cloud 时发起密码确认的账户注销；管理采集设备群的运维团队则按设备与应用版本盯紧授权到期时间，赶在现场的采集、畸变校正与 PDF 导出失效之前处理。openData Studio 把这些云库、页面与授权数据变成可调用的开放数据，支撑上述集成。

应用截图

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"
}
```
登录 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"
}
```

更新会话设备令牌

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} 的扫描许可证刷新。

与 Genius Scan - PDF Scanner 相似的应用

Microsoft Lens — Microsoft Lens 是免费文档扫描应用，可拍摄纸页、白板和名片，并导出到 OneDrive、Word 等 Microsoft 365 应用。
Adobe Scan — Adobe Scan 把相机照片转成带文字识别的 PDF，并可送到 Adobe Acrobat 继续编辑。
CamScanner — CamScanner 是文档扫描应用，提供编辑、文字识别和分享，用于收据、笔记和多页 PDF。
SwiftScan — SwiftScan 是移动扫描应用，在生成 PDF 之外还提供传真、云同步和工作流自动化。
Google Drive Scanner — Google Drive 内置扫描功能，把文档存成可搜索的 PDF 并直接放到网盘里。
vFlat Scan — vFlat Scan 面向书籍扫描，能自动检测页面并拉平弯曲的书页。
Scanner Pro — Scanner Pro 是 Readdle 的文档扫描应用，用于拍摄、整理并导出多页 PDF。
iScanner — iScanner 是带文字识别和编辑功能的移动文档扫描应用，常被列为 Genius Scan 的替代选择。

需要集成这个 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 档案

文档云库增量备份

账户生命周期与注销

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

常见问题

与 Genius Scan - PDF Scanner 相似的应用

更多效率工具类应用

Call Blocker - Blacklist

CFE Contigo

Enel São Paulo

Fast Scanner - PDF Scan App

相关主题

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

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

应用截图

API 端点一览

注册 Genius Cloud 会话

登录 Genius Cloud

按用户 uid 重连会话

更新会话设备令牌

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

获取单个云文档

更新云文档

删除云文档

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

获取 Genius Cloud 用户

更新用户邮箱

删除 Genius Cloud 用户

刷新 Genius Scan SDK 许可证密钥

数据类别

数据使用场景与案例

从扫描证件构建 KYC 档案

文档云库增量备份

账户生命周期与注销

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

常见问题

相关应用

与 Genius Scan - PDF Scanner 相似的应用

更多效率工具类应用

Call Blocker - Blacklist

CFE Contigo

Enel São Paulo

Fast Scanner - PDF Scan App

相关主题

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