Adobe Scan AI PDF Scanner, OCR 图标

Adobe Scan 数据 API:云端扫描、OCR 与全文搜索

Adobe · 效率工具

Adobe Scan 是 Adobe 面向 Document Cloud 的移动扫描应用:用手机摄像头采集收据、证件、合同与白板,清理图像后以 PDF 归档。它位于工具与效率市场,服务美国、印度与墨西哥庞大的免费用户群,满足把纸张变成可搜索文档的需求。

作为数据源,该应用同时开放扫描背后的账户与档案本身:displayName、email 与 countryCode 等身份字段,存储信封 storageQuota / storageUsed / storageRemaining,以及 pageCount、tags 与 scanMetadata.createdByScan 等单文档元数据。集成方在其之上构建收据库、跨扫描件全文搜索与配额感知的采集流水线。

Adobe Scan 是 Adobe 的拍照转 PDF 扫描应用,把收据、合同与白板照片变成可搜索的 OCR PDF,存入 Document Cloud,在美国、印度与墨西哥拥有庞大的免费用户群。采集流程背后是一套丰富的数据集:含套餐与国家的 Adobe 登录身份、账户的存储配额与区域,以及文档带有页数、标签、扫描来源标记与全文搜索命中的扫描库。这些数据可支撑基于用户自有扫描档案的收据库、档案检索与配额感知采集集成。

应用截图

  • Adobe Scan AI PDF Scanner, OCR 应用截图 1
  • Adobe Scan AI PDF Scanner, OCR 应用截图 2
  • Adobe Scan AI PDF Scanner, OCR 应用截图 3
  • Adobe Scan AI PDF Scanner, OCR 应用截图 4
  • Adobe Scan AI PDF Scanner, OCR 应用截图 5
  • Adobe Scan AI PDF Scanner, OCR 应用截图 6
  • Adobe Scan AI PDF Scanner, OCR 应用截图 7
  • Adobe Scan AI PDF Scanner, OCR 应用截图 8

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。

  • 签发访问令牌

    POST /v1/scancloud/auth/token opendata

    把授权码或 refresh_token 兑换为 Bearer access_token,账户、文档、搜索与任务调用会把它作为 Authorization: Bearer 附加。

    认证方式: 令牌调用本身无需认证。请求体携带 grant_type(authorization_code 或 refresh_token)与 client_id。返回的 access_token 在后续云调用中以 Authorization: Bearer 发送,x-api-key 设为应用客户端 ID。

    • grant_type
    • client_id
    • code
    • refresh_token
    • access_token
    • token_type
    • expires_in
    POST /v1/scancloud/auth/token HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
    
    grant_type=authorization_code&client_id=scan-android-client&code=SplxlOBeZQQYbYS6WxSbIA
    {
      "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example",
      "token_type": "bearer",
      "expires_in": 86400,
      "refresh_token": "XAa1eFv3k3qQYk1z3xY2bQ"
    }
    • 依据应用的登录与令牌兑换流程重建
    • 与每个云调用附加的 Bearer 凭证一致
  • 发现云端操作目录

    GET /v1/catalog opendata

    返回客户端缓存的操作目录:每个云操作(get_profile、upload、convert、list、文档操作)都携带 uri、httpMethod、accept/contentType 配置与 authentication。

    认证方式: Authorization: Bearer <access_token>,来自 POST /v1/scancloud/auth/token。Accept 是携带目录配置的供应商 JSON 媒体类型。客户端还发送 x-api-key。

    • expiry
    • resources
    • templates
    • uri
    • httpMethod
    • authentication
    • accept
    • contentType
    • uriParameters
    • formDataParameters
    GET /v1/catalog HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="catalog_v1.json"
    x-api-key: scan-android-client
    {
      "expiry": 1727606400000,
      "resources": {
        "account": {
          "get_profile": {
            "uri": "/v1/scancloud/account/profile",
            "httpMethod": "GET",
            "authentication": ["bearer"]
          }
        },
        "documents": {
          "upload": {
            "uri": "/v1/documents",
            "httpMethod": "POST"
          },
          "convert": {
            "uri": "/v1/documents/convert",
            "httpMethod": "POST"
          }
        }
      },
      "templates": {}
    }
    • 依据应用首次运行的引导流程重建,该流程在任何账户调用之前缓存操作目录
  • 读取云账户身份

    GET /v1/scancloud/account/profile osint

    返回已登录 Adobe ID(userId、email、displayName、countryCode),以及云配额、存储区域与订阅代码,它们在应用内门控 OCR 与上传限额。

    认证方式: Authorization: Bearer <access_token>。Accept 配置选择账户表示。可选查询参数 fields 选择 identity、存储限额、subscriptions 等切片。

    • identity
    • userId
    • userUri
    • email
    • displayName
    • firstName
    • lastName
    • countryCode
    • language
    • category
    • analyticsPlanCode
    • mrktPermEmail
    • limitsStorageDocumentCloud
    • storageQuota
    • storageUsed
    • storageRemaining
    • storageSlop
    • storageDocumentCloud
    • region
    • encryptionKeyStatus
    • subscriptions
    GET /v1/scancloud/account/profile?fields=identity,storageLimits,subscriptions HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="account_v1.json"
    x-api-key: scan-android-client
    {
      "identity": {
        "userId": "A3F9C2D1B8470E56",
        "userUri": "/v1/scancloud/account/A3F9C2D1B8470E56",
        "email": "[email protected]",
        "displayName": "Ada Lovelace",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryCode": "US",
        "language": "en-US",
        "category": "individual",
        "analyticsPlanCode": "free",
        "mrktPermEmail": true
      },
      "storageLimits": {
        "storageQuota": 2147483648,
        "storageUsed": 314572800,
        "storageRemaining": 1832910848,
        "storageSlop": 104857600
      },
      "storageRegion": {
        "region": "VA6",
        "encryptionKeyStatus": "available"
      },
      "subscriptions": {
        "subscriptions": [
          {
            "code": "acrobat_free",
            "displayName": "Acrobat Free",
            "features": []
          }
        ]
      }
    }
    • 依据账户页面与套餐/配额门控逻辑重建
  • 读取云存储配额

    GET /v1/account/storage opendata

    返回专用云存储信封(配额、已用、剩余、冗余),上传预检在扫描保存到云端之前检查它。

    认证方式: Authorization: Bearer <access_token>。存储信封的目录操作。Accept 配置选择配额表示。

    • storageQuota
    • storageUsed
    • storageRemaining
    • storageSlop
    GET /v1/account/storage HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="storage_v1.json"
    x-api-key: scan-android-client
    {
      "storageQuota": 2147483648,
      "storageUsed": 314572800,
      "storageRemaining": 1832910848,
      "storageSlop": 104857600
    }
    • 依据上传预检重建,它在保存扫描前检查剩余空间
  • 获取云端根集合

    GET /v1/collections/root opendata

    解析已登录用户的云端根集合(folderId、rootUri),后续列表、创建与上传调用以其为父级。

    认证方式: Authorization: Bearer <access_token>。根集合的目录操作。

    • folderId
    • rootUri
    GET /v1/collections/root HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="collection_v1.json"
    x-api-key: scan-android-client
    {
      "collectionId": "root-ada-scan",
      "collectionUri": "/v1/collections/root-ada-scan"
    }
    • 依据扫描库主页的根列表重建
  • 列出集合成员

    GET /v1/collections/{collectionId}/items opendata

    把云集合内容分页为成员(文档或子集合),带 name、size、pageCount、tags 与 favorite/starred/shared 标志。

    认证方式: Authorization: Bearer <access_token>。目录列表操作。路径参数 collection_id。

    • uri
    • parentUri
    • name
    • source
    • totalMembers
    • pages
    • members
    • type
    • assetId
    • assetUri
    • folderId
    • folderUri
    • created
    • modified
    • lastAccess
    • size
    • pageCount
    • lastPagenum
    • favorite
    • starred
    • shared
    • parentId
    • tags
    • customTags
    GET /v1/collections/root-ada-scan/items?page_size=50&order_by=modified&sort_order=desc&metadata=basic HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="collection_listing_v1.json"
    x-api-key: scan-android-client
    {
      "uri": "/v1/collections/root-ada-scan",
      "parentUri": null,
      "name": "Document Cloud",
      "source": "document_cloud",
      "totalMembers": 2,
      "pages": {
        "nextPageUri": null
      },
      "members": [
        {
          "type": "document",
          "assetId": "doc-receipt-0412",
          "assetUri": "/v1/documents/doc-receipt-0412",
          "name": "Cafe receipt 12 Apr.pdf",
          "created": "2026-04-12T09:14:22Z",
          "modified": "2026-04-12T09:15:01Z",
          "lastAccess": "2026-09-20T18:02:11Z",
          "size": 245760,
          "pageCount": 1,
          "lastPagenum": 1,
          "favorite": false,
          "starred": false,
          "shared": false,
          "parentId": "root-ada-scan",
          "parentUri": "/v1/collections/root-ada-scan",
          "source": "scan",
          "tags": ["receipt"],
          "customTags": []
        }
      ]
    }
    • 依据扫描库的分页文档列表重建
  • 读取扫描文档元数据

    GET /v1/documents/{documentId} opendata

    返回单个扫描件的基础云元数据(name、size、pageCount、source、tags、scanModifiedAt),使库行与详情页无需下载字节即可渲染。

    认证方式: Authorization: Bearer <access_token>。目录元数据操作。路径参数 document_id。

    • assetId
    • uri
    • name
    • type
    • source
    • size
    • pageCount
    • lastPagenum
    • created
    • modified
    • lastAccess
    • scanModifiedAt
    • favorite
    • starred
    • shared
    • parentId
    • parentUri
    • tags
    • customTags
    • bookmarks
    GET /v1/documents/doc-receipt-0412 HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="document_metadata_v1.json"
    x-api-key: scan-android-client
    {
      "assetId": "doc-receipt-0412",
      "uri": "/v1/documents/doc-receipt-0412",
      "name": "Cafe receipt 12 Apr.pdf",
      "type": "document",
      "source": "scan",
      "size": 245760,
      "pageCount": 1,
      "lastPagenum": 1,
      "created": "2026-04-12T09:14:22Z",
      "modified": "2026-04-12T09:15:01Z",
      "lastAccess": "2026-09-20T18:02:11Z",
      "scanModifiedAt": "2026-04-12T09:15:01Z",
      "favorite": false,
      "starred": false,
      "shared": false,
      "parentId": "root-ada-scan",
      "parentUri": "/v1/collections/root-ada-scan",
      "tags": ["receipt"],
      "customTags": [],
      "bookmarks": null
    }
    • 依据无需下载字节即可渲染的文档详情页重建
  • 创建云集合

    POST /v1/collections opendata

    在 parentUri 下创建命名子集合,当同级已占用该名称时应用 onDupName——即扫描库中的新建文件夹操作。

    认证方式: Authorization: Bearer <access_token>。目录创建操作。集合创建的供应商 JSON 内容配置。

    • name
    • parentUri
    • onDupName
    • folderId
    • uri
    POST /v1/collections HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: application/vnd.scan.cloud+json;profile="collection_creation_v1.json"
    x-api-key: scan-android-client
    
    {
      "name": "Receipts 2026",
      "parentUri": "/v1/collections/root-ada-scan",
      "onDupName": "auto_rename"
    }
    {
      "collectionId": "fld-receipts-2026",
      "uri": "/v1/collections/fld-receipts-2026",
      "name": "Receipts 2026",
      "parentUri": "/v1/collections/root-ada-scan"
    }
    • 依据扫描库中的新建文件夹操作重建
  • 上传扫描文档

    POST /v1/documents opendata

    把采集的页面或 PDF 上传到 parentUri 下的云端,带 persistence 与 onDupName 选项;返回的 assetUri 供转换与文档操作调用使用。

    认证方式: Authorization: Bearer <access_token>。目录上传操作。Multipart 表单:options JSON 加页面图像或 PDF 正文。

    • name
    • parentUri
    • onDupName
    • persistence
    • instantUpload
    • ignoreContentType
    • assetId
    • assetUri
    • contentType
    • size
    POST /v1/documents HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: multipart/form-data
    x-api-key: scan-android-client
    
    --boundary
    Content-Disposition: form-data; name="options"
    Content-Type: application/vnd.scan.cloud+json;profile="document_upload_v1.json"
    
    {
      "name": "Cafe receipt 12 Apr.jpg",
      "parentUri": "/v1/collections/root-ada-scan",
      "onDupName": "auto_rename",
      "persistence": "permanent",
      "instantUpload": true,
      "ignoreContentType": false
    }
    --boundary
    Content-Disposition: form-data; name="file"; filename="page.jpg"
    Content-Type: image/jpeg
    
    <binary>
    --boundary--
    {
      "assetId": "doc-receipt-0412",
      "assetUri": "/v1/documents/doc-receipt-0412",
      "name": "Cafe receipt 12 Apr.jpg",
      "parentUri": "/v1/collections/root-ada-scan",
      "contentType": "image/jpeg",
      "size": 1843200
    }
    • 依据页面采集后的保存到云端流程重建
  • 创建带 OCR 的可搜索 PDF

    POST /v1/documents/convert opendata

    把已上传的扫描件转成带可选 OCR(doOcr、ocrLang、ocrType)的 PDF,并返回客户端轮询的 jobUri,直到可搜索 PDF 文档就绪。

    认证方式: Authorization: Bearer <access_token>。目录转换操作。长时间运行的工作返回待轮询的 jobUri。

    • assetUri
    • name
    • parentUri
    • doOcr
    • ocrLang
    • ocrType
    • onDupName
    • persistence
    • showMarkup
    • taggedPdfFormat
    • jobUri
    • status
    POST /v1/documents/convert HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: application/vnd.scan.cloud+json;profile="convert_v1.json"
    x-api-key: scan-android-client
    
    {
      "assetUri": "/v1/documents/doc-receipt-0412",
      "name": "Cafe receipt 12 Apr.pdf",
      "parentUri": "/v1/collections/root-ada-scan",
      "doOcr": true,
      "ocrLang": "en-US",
      "ocrType": "searchable_image",
      "onDupName": "auto_rename",
      "persistence": "permanent",
      "showMarkup": false,
      "taggedPdfFormat": "none"
    }
    {
      "jobUri": "/v1/scancloud/jobs/job-convert-0412",
      "status": "in progress",
      "assetUri": "/v1/documents/doc-receipt-0412-pdf"
    }
    • 依据扫描采集后展示的 OCR 转 PDF 流程重建
  • 运行文档操作(OCR、优化、加密)

    POST /v1/documents/actions opendata

    对一个或多个文档应用文档操作流水线——带 lang 的 OCR、optimize、passwordEncrypt / removePasswordEncryption、taggedPdf——并返回 jobUri。

    认证方式: Authorization: Bearer <access_token>。目录操作接口。文档操作的供应商 JSON 内容配置。

    • name
    • parentUri
    • onDupName
    • persistence
    • assets
    • assetUri
    • pdfActions
    • ocr
    • lang
    • optimize
    • passwordEncrypt
    • removePasswordEncryption
    • taggedPdf
    • jobUri
    • status
    POST /v1/documents/actions HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: application/vnd.scan.cloud+json;profile="document_actions_v1.json"
    x-api-key: scan-android-client
    
    {
      "name": "Cafe receipt 12 Apr.pdf",
      "parentUri": "/v1/collections/root-ada-scan",
      "onDupName": "auto_rename",
      "persistence": "permanent",
      "documents": [
        {"assetUri": "/v1/documents/doc-receipt-0412-pdf"}
      ],
      "actions": [
        {"ocr": {"lang": "en-US"}},
        {"optimize": {}}
      ]
    }
    {
      "jobUri": "/v1/scancloud/jobs/job-actions-0412",
      "status": "in progress"
    }
    • 依据对已保存 PDF 的 OCR、优化与密码操作重建
  • 轮询文档任务

    GET /v1/scancloud/jobs/{jobId} opendata

    按 jobUri 轮询转换、操作或导出任务,直到 status 为 done(或 queued / in progress / failed)且 assetResult.uri 可下载。

    认证方式: Authorization: Bearer <access_token>。路径参数 job_id。

    • jobUri
    • status
    • progress
    • retryInterval
    • assetResult
    • id
    • name
    • mimetype
    • uri
    GET /v1/scancloud/jobs/job-convert-0412 HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="job_v1.json"
    x-api-key: scan-android-client
    {
      "jobUri": "/v1/scancloud/jobs/job-convert-0412",
      "status": "done",
      "progress": 100,
      "retryInterval": 0,
      "assetResult": {
        "id": "doc-receipt-0412-pdf",
        "name": "Cafe receipt 12 Apr.pdf",
        "mimetype": "application/pdf",
        "uri": "/v1/documents/doc-receipt-0412-pdf"
      }
    }
    • 依据转换运行时显示的进度指示器重建
  • 签发文档内容链接

    GET /v1/documents/{documentId}/content-link opendata

    返回云文档的短期下载链接,使应用能从文件存储拉取 OCR 后的 PDF 或原始扫描字节。

    认证方式: Authorization: Bearer <access_token>。目录 content-link 操作。

    • assetUri
    • uri
    • contentType
    • size
    GET /v1/documents/doc-receipt-0412-pdf/content-link HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.cloud+json;profile="content_link_v1.json"
    x-api-key: scan-android-client
    {
      "assetUri": "/v1/documents/doc-receipt-0412-pdf",
      "uri": "/v1/download/doc-receipt-0412-pdf?token=short-lived",
      "contentType": "application/pdf",
      "size": 245760
    }
    • 依据拉取 PDF 字节的打开/分享流程重建
  • 获取扫描缩略图预览

    GET /v1/documents/{documentId}/preview opendata

    流式返回云文档的直接图像预览(format、size),使扫描库无需下载完整 PDF 即可显示页面缩略图。

    认证方式: Authorization: Bearer <access_token>。目录预览操作。查询参数 format 与 size。

    • asset_id
    • format
    • size
    GET /v1/documents/doc-receipt-0412-pdf/preview?format=png&size=256 HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: image/png
    x-api-key: scan-android-client
    <binary PNG thumbnail bytes>
    • 依据扫描库的缩略图网格重建
  • 把 PDF 导出为其他格式

    POST /v1/documents/{documentId}/export opendata

    把云端 PDF 异步转换为其他格式(format,可选 doOcr / ocrLang、imageParams)——即扫描件上的导出为 Word / 图像操作。

    认证方式: Authorization: Bearer <access_token>。目录导出操作。导出的供应商 JSON 内容配置。

    • assetUri
    • name
    • parentUri
    • format
    • doOcr
    • ocrLang
    • imageParams
    • onDupName
    • persistence
    • jobUri
    • status
    POST /v1/documents/doc-receipt-0412-pdf/export HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: application/vnd.scan.cloud+json;profile="export_v1.json"
    x-api-key: scan-android-client
    
    {
      "name": "Cafe receipt 12 Apr.docx",
      "parentUri": "/v1/collections/root-ada-scan",
      "format": "docx",
      "doOcr": true,
      "ocrLang": "en-US",
      "onDupName": "auto_rename",
      "persistence": "permanent"
    }
    {
      "jobUri": "/v1/scancloud/jobs/job-export-0412",
      "status": "in progress"
    }
    • 依据扫描件上的导出为 Word / 图像操作重建
  • 数字化采集页面(AI)

    POST /v1/ai/digitize opendata

    把采集的页面提交到 AI 数字化服务(processingLevel 为 digitized_image、pdf 或 searchable_pdf,locale)作为异步任务;客户端随后轮询 status_out 直到 completed。

    认证方式: Authorization: Bearer <access_token>,来自 POST /v1/scancloud/auth/token。Multipart 表单:contentAnalyzerRequests JSON 加页面图像。

    • contentAnalyzerRequests
    • engines
    • executionInfo
    • senseiEngine
    • digitizeParams
    • processingLevel
    • locale
    • model
    • saveIntermediateFiles
    • customInstructions
    • digitizeOut
    • statusOut
    • multipartFieldName
    • format
    • status
    • location
    POST /v1/ai/digitize HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: multipart/form-data
    
    --boundary
    Content-Disposition: form-data; name="contentAnalyzerRequests"
    Content-Type: application/json
    
    {
      "engines": [
        {
          "executionInfo": {
            "engine": "digitize-engine-v3"
          },
          "params": {
            "digitizeParams": {
              "processingLevel": "searchable_pdf",
              "locale": "en-US",
              "model": null,
              "saveIntermediateFiles": false,
              "customInstructions": null
            }
          },
          "outputs": {
            "digitizeOut": {"multipartFieldName": "outfile", "format": "application/pdf"},
            "statusOut": {"multipartFieldName": "status_out", "format": "application/x-ndjson"}
          }
        }
      ]
    }
    --boundary
    Content-Disposition: form-data; name="file"; filename="page.jpg"
    Content-Type: image/jpeg
    
    <binary>
    --boundary--
    {
      "status": "in progress",
      "location": "/v1/ai/digitize/tasks/dig-0412"
    }
    • 依据应用的采集页面 AI 数字化流程重建
  • 轮询数字化任务状态

    GET /v1/ai/digitize/{taskId} opendata

    轮询数字化任务,直到 status 为 completed、error 或 null,以便应用拉取 outfile 字节(可搜索 PDF 或数字化图像)。

    认证方式: Authorization: Bearer <access_token>。Accept 是供应商任务状态媒体类型。查询 outputName=status_out 与 nonMultipart=true。Prefer: respond-partial, wait=10。

    • outputName
    • nonMultipart
    • status
    • outputs
    • status_out
    • code
    GET /v1/ai/digitize/dig-0412?outputName=status_out&nonMultipart=true HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Accept: application/vnd.scan.digitize.status+json
    Prefer: respond-partial, wait=10
    {
      "status": "completed",
      "outputs": {
        "status_out": {
          "code": "200"
        }
      }
    }
    • 依据数字化进度轮询循环重建
  • 搜索云端文档

    POST /v1/search/query opendata

    用查询 q、类型/范围过滤与排序在云库上运行全文搜索;命中包含 scanMetadata.createdByScan 与 pageTypes,使主页搜索能高亮扫描件。

    认证方式: Authorization: Bearer <access_token>,来自 POST /v1/scancloud/auth/token。

    • q
    • limit
    • scope
    • documentCloudAssetType
    • favourite
    • parentId
    • sortOrder
    • sortOrderby
    • type
    • status
    • metrics
    • resultSets
    • createDate
    • modifyDate
    • region
    • createdByScan
    • pageTypes
    POST /v1/search/query HTTP/1.1
    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
    Content-Type: application/json
    
    {
      "q": "receipt cafe",
      "limit": 25,
      "scope": ["document_cloud"],
      "documentCloudAssetType": ["pdf"],
      "favourite": false,
      "sortOrderby": "modifyDate",
      "sortOrder": "desc"
    }
    {
      "status": [{"code": "ok"}],
      "metrics": {"total": 1},
      "resultSets": [
        {
          "items": [
            {
              "name": "Cafe receipt 12 Apr.pdf",
              "createDate": "2026-04-12T09:15:01Z",
              "modifyDate": "2026-04-12T09:15:01Z",
              "region": "VA6",
              "scanMetadata": {
                "createdByScan": true,
                "pageTypes": ["receipt"]
              }
            }
          ]
        }
      ]
    }
    • 依据过滤扫描来源 PDF 的主页搜索框重建

数据类别

  • 身份
  • 存储配额
  • 文件夹
  • 文档
  • OCR 任务
  • 搜索
  • 会话
  • 数字化

数据使用场景与案例

  • OCR PDF 收据库

    报销团队登录后列出 Document Cloud 集合(assetId、name、pageCount、tags、size),并对每个 source 或 scanMetadata.createdByScan 标记为收据的扫描件拉取 content-link 字节。

  • 配额感知的扫描采集

    采集流水线在上传页面前先从账户存储接口读取 storageUsed / storageQuota / storageRemaining,随后要么以 doOcr 与 ocrLang 运行 PDF 转换,要么把页面提交到 AI 数字化接口并设置 processingLevel 为 searchable_pdf 与 locale,使每一页都以可搜索 PDF 落入已知的父集合。

  • 身份与套餐门控

    合规任务从账户资料接口记录 userId、email、displayName、countryCode 与订阅代码,使 OCR 与导出权限能按 Adobe ID 而非按设备审计。

  • 跨扫描件全文检索

    档案检索把 q、documentCloudAssetType 与 sortOrderby 提交到搜索接口,保留 scanMetadata.pageTypes 含 receipt 或 id-card 的命中,然后打开匹配的文档。

常见问题

Adobe Scan 如何认证其云端调用?

应用在 POST /v1/scancloud/auth/token 以 authorization_code 或 refresh_token 授权类型登录,把返回的 access_token 以 Authorization: Bearer 附加到后续调用,并附带 x-api-key 客户端 ID。随后一次目录调用返回每个账户、文档与任务操作的 URI 与 HTTP 方法。

账户接口返回哪些身份与配额字段?

资料调用返回 identity.userId、email、displayName、firstName、lastName、countryCode 与 language,以及 storageQuota、storageUsed、storageRemaining 与 storageSlop、存储区域和订阅代码。专用存储调用会重复配额切片,用于扫描保存到云端之前的预检。

一页拍摄的照片如何变成可搜索 PDF?

客户端在 POST /v1/documents 上传页面图像并携带名称、父集合与 persistence 选项,然后以 OCR 标志(doOcr、ocrLang、ocrType)启动转换。返回的 jobUri 在 GET /v1/scancloud/jobs/{jobId} 轮询直至 status 为 done,再由 content-link 调用签发可下载的 PDF。额外的 OCR、优化或加密以文档操作运行,而数字化界面则把照片提交到 POST /v1/ai/digitize 并设置 processingLevel 为 searchable_pdf。

我可以只搜索扫描件而非所有云文件吗?

POST /v1/search/query 接受 q、scope、documentCloudAssetType、favourite 与 sortOrderby。命中可携带 scanMetadata.createdByScan 与 pageTypes,因此客户端可以保留源自相机的 PDF,丢弃来自其他渠道的文件。

与 Adobe Scan AI PDF Scanner, OCR 相似的应用

  • Microsoft Lens — Microsoft Lens 是微软的免费文档扫描应用,支持 OCR 并可导出到 Word、PowerPoint 和 OneNote;微软于 2026 年初停用该应用,将扫描功能并入 OneDrive。
  • CamScanner — CamScanner 是一款带 OCR 的文档扫描应用,免费版需要注册账号,导出的扫描件会带有水印。
  • Genius Scan - PDF Scanner — Genius Scan 的免费版无需注册账号、不加水印,OCR 功能则以付费附加形式解锁。
  • Google Drive — Google Drive 在 Android 上内置扫描按钮,可自动裁剪、增强页面,并保存为可搜索的 PDF 存入 Drive。
  • vFlat Scan — vFlat Scan 是一款免费扫描应用,设备端 OCR 可离线识别约 30 种语言,还能展平弯曲的书页,无需注册也不加水印。
  • PDF Scanner & Editor by Kaagaz — Kaagaz Scanner 是印度本土开发的 PDF 扫描与制作应用,定位为 CamScanner 的印度替代品。
  • iScanner — iScanner 是一款 OCR 扫描应用,其附加功能还能通过摄像头清点物体数量、测量距离和解数学题。

相关主题

  • Adobe Scan API
  • Adobe Scan Document Cloud
  • Adobe Scan OCR PDF
  • Adobe Scan 访问令牌
  • Document Cloud 存储配额
  • Adobe Scan 文件夹列表
  • Adobe Scan 扫描件搜索
  • scanMetadata createdByScan

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

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

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

获取报价