> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# document_subtype 证件子类型代码参考：完整列表

> 查看 Didit 身份证件验证报告支持的所有 document_subtype 代码、命名规则模式以及如何区分商业驾照。

[身份证件验证报告](https://docs.didit.me/zh/core-technology/id-verification/report-id-verification.md)中的 `document_subtype` 用于标识 Didit 识别的具体证件变体，例如昆士兰州驾驶执照与通用驾驶执照，或是美国商用驾驶执照（CDL）与标准驾驶执照。本页面列举了该字段可能返回的所有值。> [!NOTE]
>
> 您自己的工作流仅接受这些值的一个子集，即您在工作流的证件设置步骤中所选定的内容。请通过 Management API 的工作流检索 endpoint（OCR 节点上的 `documents_allowed`）获取您工作流所接受的确切列表，而不要假定下方列出的所有值都已为您启用。## 命名规则每个 `document_subtype` 值均采用以下两种形式之一：- **基础类别**：`{CATEGORY}`，适用于 Didit 无需按地区进行区分的证件（大多数护照、大多数国民身份证），例如 `PASSPORT_GENERIC`、`ID_CARD_GENERIC`。
- **带地区前缀**：`{REGION}_{CATEGORY}`，适用于其格式或分类在州、省或地区之间存在实质差异的证件，例如 `QUEENSLAND_DRIVER_LICENSE_GENERIC`（澳大利亚）或 `CALIFORNIA_COMMERCIAL_DL`（美国）。地区前缀是签发州、省或领地的名称，采用大写形式并将空格替换为下划线。只有当 Didit 的证件注册表中包含该地区单独分类的独特变体时，证件才会获得带地区前缀的子类型。没有带地区前缀的变体并不意味着该证件类型在该地区不存在，这仅代表 Didit 目前将其归入国家/地区级的基础类别下进行报告（具体示例请参阅下方的 CDL 注意事项）。## 所有子类型值下表是报告可能返回的 `document_subtype` 值的完整枚举，按 `document_type` 系列分组。表中已包含带地区前缀的变体，例如 `DRIVER_LICENSE_GENERIC`（大多数国家/地区）和 `CALIFORNIA_DRIVER_LICENSE_GENERIC` 均作为不同的行出现在 Driver's License 下。基础类别代码并非特定国家/地区独有，而是由证件注册表条目中没有特定地区变体的所有国家/地区共用。例如，`ID_CARD_GENERIC` 涵盖了大约 170 个国家/地区的国民身份证。请务必仅通过其 `document_type` 分组以及（存在时的）地区前缀来查询代码，切勿假定一个代码仅对应单一国家/地区。

\<table><thead><tr><th>document_subtype</th></tr></thead>
        \<tbody /></table>

## 美国驾驶执照: 标准 vs 商业 (CDL)对于标准驾驶执照和商用驾驶执照（CDL），`document_type` 均为 `"Driver's License"`，从不对两者进行区分。这种区分完全体现在 `document_subtype` 中。**在 Didit 分类的 51 个美国州及领地中，有 48 个州/领地的 CDL 拥有独立的 `{STATE}_COMMERCIAL_DL` 子类型，有别于该州/领地的 `{STATE}_DRIVER_LICENSE_GENERIC`。** 在这些州，将以 `_COMMERCIAL_DL` 结尾的 `document_subtype` 视为“这是一张 CDL”是一个可靠的信号。> [!WARNING]
>
> **阿拉斯加州、哥伦比亚特区和夏威夷州目前没有独立的 CDL 子类型。** 来自这三个司法管辖区的 CDL 会在其标准的 `_DRIVER_LICENSE_GENERIC` 子类型下报告，仅凭 `document_subtype` 无法将其与非商业执照区分开来。如果您特别需要对这三个司法管辖区进行严格的 CDL 检测，请[联系我们](mailto:support@didit.me)以注册缺失的证件变体，或者应用带外控制措施（例如，要求驾驶员单独提供其 CDL/DOT 编号以供核验）。

\<table><thead><tr><th>州/领地</th>
            \<th>标准驾照子类型</th>
            \<th>商业驾照（CDL）子类型</th>
            \<th>其他子类型（学习型、临时型、增强型…）</th></tr></thead>
        \<tbody /></table>

### `extra_fields.dl_categories` 不是可靠的 CDL 信号部分美国执照还会生成 `extra_fields.dl_categories`，即通过 OCR 读取的卡片上印制的准驾车型字母列表（`A`、`B`、`C`……）。**切勿将其用作您的 CDL 信号。** 目前，仅有极少数美国驾驶执照配置会填充此字段，各州准驾车型字母的含义各不相同，且未针对商业/非商业语义进行规范化，而签注或限制代码（许多执照实际上通过这些代码标注“商业”）目前根本未在报告中公开。目前，`document_subtype` 是区分标准驾照与商业驾照唯一结构化、可靠的信号。## 保持同步新的 `document_type` 系列在发布时会在每月更新日志中公布。`document_subtype` 的新增（例如现有证件类型的新地区变体）目前不会单独公布；随着新证件格式的入驻，Didit 的证件注册表会持续扩充。此列表的 Webhook payload 中不包含版本号。如果您的集成需要检测从未见过的子类型，而不是假定该集合是固定的，请将代码无法识别的任何 `document_subtype` 值视为“未分类，人工审核”，而不是直接报错，并定期重新查看本页面或通过 Management API 查看工作流接受的子类型列表。## 相关- [身份证件验证报告](https://docs.didit.me/zh/core-technology/id-verification/report-id-verification.md)：上下文中的 `document_type` / `document_subtype` 字段。
- [支持的身份证件](https://docs.didit.me/zh/core-technology/id-verification/supported-documents-id-verification.md)：Didit 支持的国家/地区和证件类型。
- [数据模型 - 身份证件验证](https://docs.didit.me/zh/reference/data-models.md#身份证件验证)：规范字段结构。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.