快速开始
集成 / SDK
用户验证
企业验证
交易监控
更新日志document_subtype 用于标识 Didit 识别的具体证件变体，例如昆士兰州驾驶执照与通用驾驶执照，或是美国商用驾驶执照（CDL）与标准驾驶执照。本页面列举了该字段可能返回的所有值。
您自己的工作流仅接受这些值的一个子集，即您在工作流的证件设置步骤中所选定的内容。请通过 Management API 的工作流检索 endpoint（OCR 节点上的
documents_allowed）获取您工作流所接受的确切列表，而不要假定下方列出的所有值都已为您启用。命名规则
每个document_subtype 值均采用以下两种形式之一：
- 基础类别：
{CATEGORY}，适用于 Didit 无需按地区进行区分的证件（大多数护照、大多数国民身份证），例如PASSPORT_GENERIC、ID_CARD_GENERIC。 - 带地区前缀：
{REGION}_{CATEGORY}，适用于其格式或分类在州、省或地区之间存在实质差异的证件，例如QUEENSLAND_DRIVER_LICENSE_GENERIC（澳大利亚）或CALIFORNIA_COMMERCIAL_DL（美国）。地区前缀是签发州、省或领地的名称，采用大写形式并将空格替换为下划线。
所有子类型值
下表是报告可能返回的document_subtype 值的完整枚举，按 document_type 系列分组。表中已包含带地区前缀的变体，例如 DRIVER_LICENSE_GENERIC（大多数国家/地区）和 CALIFORNIA_DRIVER_LICENSE_GENERIC 均作为不同的行出现在 Driver’s License 下。
基础类别代码并非特定国家/地区独有，而是由证件注册表条目中没有特定地区变体的所有国家/地区共用。例如，ID_CARD_GENERIC 涵盖了大约 170 个国家/地区的国民身份证。请务必仅通过其 document_type 分组以及（存在时的）地区前缀来查询代码，切勿假定一个代码仅对应单一国家/地区。
美国驾驶执照: 标准 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”是一个可靠的信号。
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 查看工作流接受的子类型列表。
相关
- 身份证件验证报告：上下文中的
document_type/document_subtype字段。 - 支持的身份证件：Didit 支持的国家/地区和证件类型。
- 数据模型 - 身份证件验证：规范字段结构。