介绍
为 Web 设计、实现和维护 API 不仅仅是一项挑战;对很多公司来说,这是一项势在必行的任务。本系列将带领读者走过一段旅程,从为 API 确定业务用例到设计方法论,解决实现难题,并从长远的角度看待在 Web 上维护公共 API。沿途将会有对有影响力的人物的访谈,甚至还有 API 及相关主题的推荐阅读清单。
内容
从商业角度探讨API 设计
本文是Web API 设计系列的第一篇文章,作者 Matt McLarty从商业角度探讨了 API 的设计,无论它是否是开放式并且公开发布的。本篇论及了让 API 反映出业务价值的重要性,论述了在业务系统中应当使用的数据类型,并从 Amazon 和 Twilio 的成功中学习他们的经验。
与HAL 的创造者Mike Kelly 的一次访谈
作为Web API 系列文章的一部分,Mike Amundsen 与 Mike Kelly进行了一次访谈,谈论了他创建 HAL 背后的原因,以及他在这三年来与 web 开发者和 API 社区交流的经验。
Web API 设计方法论
Mike Amundsen在本文中为读者简单介绍了在他的书籍《RESTful Web APIs》中所谈到的设计方法论,使用这种方法论的 API 设计将能够同时利用到 HTTP 与 Web 这两方面的功能。
实现超媒体
在本文中, Steve Klabnik将讨论四种关于超媒体在真实情况中的实现场景:在图片链接中使用超媒体(你很可能已经使用过这种方式了)、GitHub 是如何使用 Link 头信息实现分页的、在例如 iOS 这样的受限系统中使用超媒体,以及 Balanced 是如何使用超媒体理论开发产品的故事。
与Roy Fielding 谈论版本化、超媒体以及REST
Roy Fielding与Mike Amundsen进行了一番对话,谈论的话题包括Web的版本化、为什么在他的REST定 **** 义中超媒体是必不可少的、设计一个能够适应未来变化的网络软件的过程、以及在设计能够在几十年之后继续可用的软件时会遇到的种种挑战等等。
有关REST 知识的阅读清单
在圆满地完成了我们的第一期Web API 系列之后, Mike Amundsen为那些希望进一步学习设计、实现及维护 Web API 相关知识的读者推荐了一些书籍。
本系列文章管理者
Mike Amundsen是一位国际知名作者和讲师,他的足迹踏遍全球,为人们讲解各种方面的知识,包括分布式网络架构、Web 应用程序开发和其它主题。在 Amundsen 担任 API Academy 的架构总裁的期间,他在北美的各处为人们传授 API 架构与设计实践的相关知识。在过去 15 年间,他编写了大量与编程相关的书籍与论文。最新的一本书是与 Leonard Richardson 合著的《RESTful Web APIs》,已在 2013 年问世。他的另一本著作《使用 HTML5 及 Node 创建超媒体 API》(2011)作为创建基于超媒体的商业应用的经典书籍,受到广泛赞誉,其内容也经常为人所引用。
评论