https://plumephp.com/tags/api-contract/Recent content in Api-Contract on PlumePHPHugozh-CNSun, 27 Sep 2026 10:30:00 +0800https://plumephp.com/api-contract-governance/Sun, 27 Sep 2026 10:30:00 +0800https://plumephp.com/api-contract-governance/<h2 id="引言">引言</h2> <p>API 一旦发布，就进入公共领域。一个 <code>GET /users</code> 接口背后可能站着几十个消费方：内部前端、移动端、数据管道、第三方集成。当你删掉一个字段、改了一个类型、或悄悄改变了分页语义，每一个破坏性变更都会像涟漪一样波及整个调用方生态。然而现实是——<strong>大部分 API 破坏性变更都不是有意的，而是&quot;悄悄发生&quot;的</strong>：有人改了字段名没改文档，有人新加了一个必填字段，有人改了枚举值。</p>https://plumephp.com/typescript-runtime-validation-typesafe/Sat, 26 Sep 2026 14:00:00 +0800https://plumephp.com/typescript-runtime-validation-typesafe/<p><strong>编译期类型再严谨，也无法保证&quot;越过进程边界&quot;的数据是安全的</strong>——HTTP 请求体、数据库行、消息队列里的消息，在运行时都可能与声明不符。这就是运行时类型安全边界（Runtime Type Safety Boundary）存在的意义：在数据进入可信域的那一刻，用 schema 做一次&quot;诚实检查&quot;。</p>