为Web设计、实现和维护API不仅仅是一项挑战;对很多公司来说,这是一项势在必行的任务。本系列将带领读者走过一段旅程,从为API确定业务用例到设计方法论,解决实现难题,并从长远的角度看待在Web上维护公共API。沿途将会有对有影响力的人物的访谈,甚至还有API及相关主题的推荐阅读清单。
本文是Web API设计系列的第一篇文章,作者 Matt McLarty 从商业角度探讨了API的设计,无论它是否是开放式并且公开发布的。本篇论及了让API反映出业务价值的重要性,论述了在业务系统中应当使用的数据类型,并从Amazon和Twilio的成功中学习他们的经验。
作为Web API系列文章的一部分,Mike Amundsen与 Mike Kelly 进行了一次访谈,谈论了他创建HAL背后的原因,以及他在这三年来与web开发者和API社区交流的经验。
Mike Amundsen 在本文中为读者简单介绍了在他的书籍《RESTful Web APIs》中所谈到的设计方法论,使用这种方法论的API设计将能够同时利用到HTTP与Web这两方面的功能。
在本文中, Steve Klabnik 将讨论四种关于超媒体在真实情况中的实现场景:在图片链接中使用超媒体(你很可能已经使用过这种方式了)、GitHub是如何使用Link头信息实现分页的、在例如iOS这样的受限系统中使用超媒体,以及Balanced是如何使用超媒体理论开发产品的故事。
Roy Fielding 与 Mike Amundsen 进行了一番对话,谈论的话题包括 Web 的版本化、 为什么在他的 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)作为创建基于超媒体的商业应用的经典书籍,受到广泛赞誉,其内容也经常为人所引用。
查看英文原文: Article Series: Web APIs: From Start to Finish