标签: API设计

周报深入剖析 Git Hooks 失效、TS 作用域冲突、Swagger OperationId 工程化、Nginx 配置、Git 忽略规则等问题，并展望技术趋势。通过案例解析和实践，提供解决方案和性能考量。推荐 Git、TS 和 Nginx 相关深入阅读资源。

RESTful API的资源更新机制中，`PUT`用于完整替换资源，而`PATCH`用于部分修改。`PUT`需发送完整资源表示并具有幂等性，`PATCH`则需指定修改指令集和格式。实践中，JSON Merge Patch和JSON Patch提供不同粒度的修改方案。分布式系统需考虑最终一致性挑战，可采用批量PATCH和乐观锁定等策略优化。GraphQL和OpenAPI为API设计提供了新思路，需注意字段冲突和版本兼容等问题。

RESTful API 设计中，`PUT`和`PATCH`均用于更新资源。`PUT`用于完整更新，需提供资源完整表示，且操作幂等；`PATCH`用于部分更新，只需发送修改数据，通常非幂等。`PUT`适用于更新全部数据，`PATCH`适用于更新部分数据。

本文介绍了 GraphQL 的核心概念：查询、突变和订阅，以及如何在 Nest.JS 中实现。查询用于获取数据，突变用于修改数据，订阅用于实时获取数据更新。文章提供了 GraphQL 语法示例和 Nest.JS 的代码实现。