2026年10月30日，欧盟DG Grow Digital Solutions正式发布《数字产品护照登记平台——面向经济运营者的接口集成指南》1.0版，面向经济运营者及其系统集成开发人员与架构师，说明如何通过登记平台与活动看板接口提交数字产品护照登记请求，并跟踪异步处理结果。指南配套登记平台、活动看板与共享组件三份开放接口规范。

1、核心机制：受理回执不等于登记完成

指南明确，登记平台接受提交后返回202受理响应并创建异步任务，响应中的任务标识用于后续活动看板操作。202响应仅表示请求已受理进入异步处理，不代表数字产品护照已被接受或登记，也不代表任务当前生命周期状态。若返回预计完成时长，仅作为首次查询时间的参考指引，不构成完成保证。

任务生命周期分为等待中、处理中、已完成与错误四种状态。指南特别强调生命周期与业务结果的分离：任务可能同时处于“已完成”状态与“失败”业务结果，后者表示负向业务结果（如提交项不合规），而非任务本身技术失败；“错误”状态才代表技术性处理失败。

2、登记原子性：一项不合规，全部不登记

登记提交具有原子性。指南规定，若任一提交项不合规，该次提交中所有数字产品护照均不予登记，包括个别已通过验证的项。任务结果通过处理信息报告提交项数、合规项数与不合规项数，但这些计数不代表部分登记。经济运营者须通过逐项处理证据端点识别不合规项，修正后以新的幂等键将完整集合作为新逻辑请求重新提交。

3、集成要点：幂等、参考数据与轮询退避

指南对集成行为提出多项明确要求：

认证与组织范围：受保护端点要求携带持有者令牌，组织与认证主体从令牌派生，客户端不在请求中传递组织标识；经济运营者须在入驻阶段完成组织验证，未具备资格的组织请求将被拒绝。

幂等提交：幂等键为必填请求头（最长128字符），重试同一逻辑提交须重用原键以返回原始任务；新逻辑提交须使用新键。幂等键按接口资源作用域限定。

先取参考数据：提交前须调用产品组查询端点获取登记平台产品分类参考数据，使用对应的产品组及（如适用）产品子组，而非任意选择。

提交规模：单次提交包含1至100个提交项，每个元素必须提供统一资源定位符格式的唯一产品标识；不同产品分类须分次提交；请求体上限为10兆字节。

轮询策略：首次查询应在估算时长后进行；任务未达终态时采用斐波那契退避（1、1、2、3、5、8、13、21、34、55秒），之后轮询间隔上限为60秒；响应含重试等待头时须至少等待该时长，且其优先于客户端轮询间隔。

4、错误处理与数据边界

指南给出提交端点的超文本传输协议状态语义：400（请求信封无效，修正后以新键重提）、403（组织无资格或调用方缺权限）、409（重复或幂等冲突）、413（超过10兆字节）、422（语义验证不可用或数据逻辑无效——数据无效用新键，验证临时不可用则以同一键重试）、429（按重试等待头等待后以同一键重试）、500（以同一键重试同一逻辑提交）。

数据处理方面，指南明确登记平台操作范围限定于认证主体关联的组织，且登记平台不持久化在解析唯一产品标识期间获取的数字产品护照载荷内容；数字产品护照资源在验证时必须可达，不可达将导致“唯一产品标识不可解析”错误。

5、端到端工作流

指南给出单护照与多护照登记的完整步骤：确认组织验证与调用权限、获取产品分类参考数据、提交并保存任务标识、按估算时长轮询任务至终态、检查业务结果与任务特定数据，需要时调用逐项证据端点获取结构化数据或逗号分隔值格式的逐项证据。任务标识用于状态与结果操作，关联标识支持端到端追踪并在提出支持请求时提供。

6、配套规范与端点

指南配套三份开放接口规范：登记平台、活动看板与共享组件，版本均为1.0.0。端点索引包括：产品组查询、登记提交、任务列表、任务详情与逐项证据五个端点。机器对机器集成的服务账户认证流程，参见《数字产品护照登记平台服务账户技术集成指南》。