2、深入解析 API 设计模式：特性、概念与重要性

深入解析 API 设计模式：特性、概念与重要性

1. 优质 API 的特性

一个优质的 API 通常具备多个重要特性，包括可操作性、表达性、简单性和可预测性。

1.1 表达性

有时候实现某些功能看似有清晰简单的方式，比如使用名为 TranslateText() 的远程过程调用（RPC）。但实际情况可能比表面更复杂。例如，API 可能已经支持某些功能，但由于疏忽，没有为用户提供便捷的访问途径。用户可能会采用一些非常规的方法来访问隐藏功能。

假设一个 API 提供了文本翻译功能，用户甚至可以利用这个 API 来检测语言，即使他们并非真正想进行翻译。以下是仅使用 TranslateText API 方法来检测语言的代码示例：

function detectLanguage(inputText: string): string { 
  const supportedLanguages: string[] = ['en', 'es', ... ]; 
  for (let language of supportedLanguages) { 
    let translatedText = TranslateApi.TranslateText({  // #A 
      text: inputText,  
      targetLanguage: language 
    }); 
    if (translatedText == inputText) {  // #B 
      return lan