4、深入理解API设计：从基础到模式应用

深入理解API设计：从基础到模式应用

1. API基础与特性

在计算机系统交互的领域中，接口和API扮演着至关重要的角色。接口是定义两个系统如何相互交互的契约，而API则是一种特殊的接口，专门用于定义两个计算机系统之间的交互方式，它有多种形式，如下载库和Web API等。

Web API尤为特殊，它通过网络暴露功能，隐藏了实现该功能所需的具体计算要求。资源导向型API则是一种设计API的方式，它通过在有限的资源集合上依赖一组标准的操作（即方法）来降低复杂性。

一个“好”的API通常具备可操作性、表达性、简单性和可预测性等特点。以可预测性为例，API在接口定义和底层行为上都不应有意外情况。例如，一个翻译文本的API，如果其 TranslateText() 方法将输入内容作为名为 text 的字段，那么当添加 DetectLanguage() 方法时，输入内容也应称为 text ，而不是 inputText 、 content 或 textContent 。

function translateText(inputText: string, 
                       targetLanguage: string, 
                       modelId?: string): string {
  return TranslateApi.Tran