`

如何设计好用的API和为什么它很重要

 
阅读更多

为什么API设计对重要

API是公司的一项巨大的资产

  1.     客户大量的投资:购买,写,学习
  2.     停止使用一个API的代价过高
  3.     成功的公共API可以获得大量用户


API也能是公司的一项巨大的负债

  •     不合格的API导致无止境的支持要求

公共的API是永恒的-做得正确只有一次机会

---------------------------------------------------

为什么API设计对你很重要


如果你是一个程序员,你就是一个API的设计者

  •     优秀代码是模块化的----每一个模块有一个API

有用的模块趋向于重用

  1.     一旦模块拥有用户,API就不能随意的改变
  2.     优秀的可重用模块是集体的财富

在API的条款内改善代码质量的思考

---------------------------------------------------

优秀API的特征

    易于学习
    易于使用,甚至不需要文档
    不容易被滥用
    代码容易被阅读和维护
    充分的满足需求
    适合受众

 

分享到:
评论

相关推荐

    java API设计

    Java API设计是一个重要的主题,它关乎到软件开发的可维护性、可扩展性和易用性。API(Application Programming Interface)是一组预定义的函数、类、接口和常量,允许开发者通过调用这些元素来实现特定功能,而无需...

    C++ API设计教程代码

    【C++ API设计教程代码】是一份专注于C++应用程序接口(API)设计的教程资源,包含了一系列相关的代码示例和文档。这个压缩包文件提供的内容可能涵盖了从基础概念到高级设计模式,以及文档编写和项目配置等多个方面...

    深度 -API 设计最佳实践的思考.pdf

    在设计API时,还要注意安全性,避免敏感信息的泄露,确保数据传输的安全。API的性能也是重要考量,包括响应时间、吞吐量和资源利用率等方面。最后,测试是验证API质量的关键环节,应包括单元测试、集成测试和压力...

    RESTful API设计规范

    #### 三、为什么选择RESTful API 1. **面向资源**:RESTful API通过URI明确地指出了资源的位置,这使得API具有良好的自解释性。 2. **轻量级**:由于将行为与资源分离,使得API的设计更加简洁明了。 3. **数据格式...

    完美API good API - keynote

    演讲者是谷歌的资深软件工程师Joshua Bloch,他通过这场演讲分享了关于如何设计一个好的API以及为什么API设计重要的知识。 在讨论API设计的重要性时,Joshua Bloch提出了几点关键的理由: 1. API可能是一个公司最...

    c++api设计

    C++ API设计是一门深奥且重要的技术,它关乎到软件的可维护性、扩展性和易用性。在本文中,我们将深入探讨C++ API设计的关键要素,包括接口设计原则、命名规范、错误处理机制、封装策略以及面向对象特性在API设计中...

    Api设计规范

    在 Java API 设计中,遵循一定的规范和最佳实践是非常重要的。本文将详细介绍 API 设计规范中的重要知识点,涵盖包设计、命名、文档、Java 类设计等方面。 包设计 在设计 API 包时,需要注意以下几点: 1. 把抽象...

    api接口设计.rar

    API接口设计是一项至关重要的任务,因为它直接影响到系统的可扩展性、灵活性和维护性。本资料"api接口设计.rar"可能包含关于如何有效地设计和实现API的详细指南。 首先,API接口设计的基础是明确接口的功能和目标。...

    设计模式手册+API大全 网上资料整理.rar

    设计模式是软件工程中的一种重要思想,它是在特定情境下,为解决常见问题而形成的一套最佳实践。设计模式手册通常会涵盖多种经典的设计模式,包括创建型、结构型和行为型三大类,如单例模式、工厂模式、适配器模式、...

    ASP.NET+Web+API设计(美)布洛克著

    本书首先介绍了Web API的基础知识,包括RESTful服务的概念、HTTP协议的核心要素,以及为什么选择Web API作为构建此类服务的工具。作者深入浅出地阐述了Web API与传统的ASP.NET MVC框架之间的关系和差异,帮助读者...

    PHP---API 接口设计教程

    PHP API 接口设计教程 PHP API 接口设计教程主要是讲解如何使用 PHP 语言来设计和实现 API 接口,本文将从基本...API 接口设计是软件开发中非常重要的一步,需要遵守基本原则和安全措施来确保 API 的可靠性和安全性。

    Windows API 程序设计参考大全

    Windows API是微软为开发者提供的一个接口,它包含了大量函数、结构体、常量和消息,用于创建、管理和控制应用程序,特别是与用户界面和系统资源交互的程序。 在Windows API中,窗口处理是核心内容之一。窗口是用户...

    浅谈关于JavaScript API设计的一些建议和准则

    对于JavaScript而言,好的API设计尤为重要,因为很多错误只能在运行时被发现。 3. 参考现代流行库:优秀的API设计可以从现代流行的JavaScript库中提取出来。设计准则往往不是凭空想象的,而是通过观察和分析成功...

    软件框架设计的艺术(Practical API Design)

    《软件框架设计的艺术》是一本面向软件设计师的宝贵资源,它不仅提供了关于API设计的深入理论知识,还分享了许多实用的技术和经验。无论你是API设计的新手还是有经验的开发者,都可以从中获得宝贵的启示和灵感。通过...

    API接口设计

    9. **性能和并发**:设计API时要考虑性能和并发处理能力。特别是在财付通这样的大型支付平台,接口需要能够高效处理大量并发请求,确保交易的及时性和稳定性。 10. **监控和日志**:实施API监控和日志记录可以帮助...

    C++设计API

    根据给出的文件信息,以下是关于“C++设计API”这本书的知识点。 首先,这本书的标题是《APIDesign for C++》,意味着它是一本专注于C++编程语言中的API(应用程序接口)设计的书籍。API设计对于软件开发来说至关...

    Java 2 安全技术-结构,API设计和实现中文版.zip

    《Java 2 安全技术-结构,API设计和实现》是针对Java编程语言中安全性这一重要主题的深度解析。这本书详细介绍了Java 2平台的安全架构、API的设计原则以及其实现机制,对于开发者来说,是深入理解Java安全性的宝贵...

Global site tag (gtag.js) - Google Analytics