原文:GOTO Berlin: Web API设计原则

在邮件列表和讨论区中有很多与REST和Web API相关的讨论,下面仅是我个人对这些问题的一些见解,并没有绝对的真理,InnoQ的首席顾问Oliver Wolf在GOTO Berlin大会上开始自己的演讲 Web API设计原则 时如是说。 不要考虑端点。SOAP有一个单独入口点的外观。相比之下Web有很多入口点,它们建立在关系上,彼此之间相互连接,并且以超媒体作为关键要素。为了不让你的API成为 ...

2013-10-23 06:24 0 2517 推荐指数:

查看详情

javascript的api设计原则

前言 本篇博文来自一次公司内部的前端分享,从多个方面讨论了在设计接口时遵循的原则,总共包含了七个大块。系卤煮自己总结的一些经验和教训。本篇博文同时也参考了其他一些文章,相关地址会在后面贴出来。很难做到详尽充实,如果有好的建议或者不对的地方,还望不吝赐教斧正。 一、接口的流畅性 好的接口是流畅 ...

Mon Jun 13 19:22:00 CST 2016 26 11912
RESTful API设计原则与规范

RESTful API设计原则与规范 一、背景与基础概念 2 二、RESTful API应遵循的原则 3 1、协议(Protocol) 3 2、域名(ROOT URL) 3 3、版本(Versioning) 3 4、路径(Endpoints) 3 5、HTTP动词 ...

Wed May 22 04:41:00 CST 2019 0 513
设计原则:小议 SPI 和 API

背景 第一次听说 SPI 是阅读《软件框架设计的艺术》,以后陆续在 Log4Net 和 Quartz.Net中发现了以这种形式组织代码的方式,本位给出为什么要区分 SPI 和 API 的一个思考过程。 从面向接口编程说起 我们在“调用方”和“实现方”之间引入了“接口”,上图没有给出“接口 ...

Tue Sep 17 17:00:00 CST 2013 2 11694
好的RESTful API设计原则

转载自一位大佬 英文原版 Principles of good RESTful API Design Good API design is hard! An API represents a contract between you and those who Consume your data. ...

Fri Apr 26 05:19:00 CST 2019 0 700
Web API接口设计(学习)

1、在接口定义中确定MVC的GET或者POST方式 由于我们整个Web API平台是基于MVC的基础上进行的API开发,因此整个Web API的接口,在定义的时候,一般需要显示来声明接口是[HttpGet]或者[HttpPost],虽然有些接口也可以不用声明,但是避免出现类似下面 ...

Thu Aug 18 19:30:00 CST 2016 0 1665
Golang Web入门(4):如何设计API

摘要 在之前的几篇文章中,我们从如何实现最简单的HTTP服务器,到如何对路由进行改进,到如何增加中间件。总的来讲,我们已经把Web服务器相关的内容大概梳理了一遍了。在这一篇文章中,我们将从最简单的一个main函数开始,慢慢重构,来研究如何把API设计的更加规范和具有扩展性。 1 构建一个Web ...

Sun Apr 26 23:26:00 CST 2020 0 947
别再设计易碎的Web API

原文作者Mathieu Fenniak在博文中大呼:不要再设计易碎的Web API 了,否则你的合作伙伴或第三方开发者会因此恨你,而离你远去的。他认为,想设计出相对稳定、牢固的API,关键在于以应用目的为中心。文中还分享了设计优秀API需要注意的几点事项,我们一起来看下: 如果破坏了API,客户 ...

Fri May 03 15:37:00 CST 2013 0 3013
 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM