接口契约设计

面向 REST 与 GraphQL 的 API 契约设计模式，涵盖 OpenAPI/Swagger 规范、版本管理策略与认证方案。内容遵循契约优先设计原则，包括资源建模与关系梳理、统一的命名规范、错误响应格式标准化、分页与过滤设计、版本策略选择、API 密钥与 OAuth 2.0 及 JWT 等认证模式，以及契约一致性检查、向后兼容与渐进演进的评审要点，帮助在实现开始之前先定义清晰、可演进的接口契约，支撑并行开发与顺畅沟通。Use when 需要设计接口契约、评审接口契约、评估接口技术选型或实现接口端点时使用。Triggers include 接口设计、契约评审、规范编写、版本管理。"如需完整版，请淘宝搜索店铺「AI灵匣」

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本