api-design

促销推文，提供免费的 API 设计手册（限时 24 小时），涵盖基础、干净设计、模式和实践概念。

RFC 10008 定义了 HTTP QUERY 方法，这是一种安全且幂等的请求方法，允许在请求体中发送查询负载，弥合了 GET 和 POST 在查询操作之间的差距。

作者构建了一个健康食品MCP服务器，并发现智能体使用多个狭窄、受限的工具比使用一个灵活的工具表现更好，强调需要一个枯燥的工具表面来减少大语言模型的幻觉。

本文介绍了一个界面设计框架，其中每个界面都有两个通道（带内和带外）用于传达关注点。文章认为，好的设计会迫使用户面对重要的关注点，而不是让他们忽略这些关注点。

关于API版本管理实践的讨论，质疑将URL路径（例如/v1/）与语义化版本控制耦合的做法，并探讨潜在的反模式。

一篇博客文章，提议重新设计 .NET 中的 System.Diagnostics.Process 类，将仅对已启动进程有效的属性分离到一个新类中，旨在减少 API 混淆。

这篇文章来自 The Old New Thing，解释了使API变得'惰性'的概念——以一种不破坏现有应用的方式'什么都不做'——并使用在Xbox上支持打印和淘汰widget API等例子。

AEP项目为protobuf和HTTP REST API提供API设计规范和工具，托管在GitHub上。

作者讨论了同时设计 MCP 和 CLI 接口时的架构挑战，权衡了功能镜像化与利用各自独特优势（CLI 的可组合性，MCP 的安全性和可审计性）之间的利弊。

本文探讨了在API中实现幂等性的复杂性，指出处理并发请求和内容不匹配等边缘情况，比简单的重放缓存更为困难。

本文以Windows的CoInitializeSecurity为例，探讨了根据链接的SDK版本改变API行为的陷阱。讨论了DLL版本不匹配和尾调用优化等问题使这种方法复杂化。