从商业角度探讨API设计
为Web设计、实现和维护API不仅仅是一项挑战；对很多公司来说，这是一项势在必行的任务。本系列将带领读者走过一段旅程，从为API确定业务用例到设计方法论，解决实现难题，并从长远的角度看待在Web上维护公共API。沿途将会有对有影响力的人物的访谈，甚至还有API及相关主题的推荐阅读清单。如今，API已...
Restful API设计规范及实战【说的比较清楚了】
RestfulAPI设计规范及实战 RestfulAPI的概念在此就不费口舌了，博友们网上查哈定义文章很多，直入正题吧：首先抛出一个问题：判断id为用户下，名称为使命召唤14(COD14)的产品是否存在(话说我还是很喜欢玩类似二战的使命召唤这款额，题外话...)？如果这个问题出现在MVC项目中，我想...
Web API设计方法论--比较完整的web api 开发过程
为Web设计、实现和维护API不仅仅是一项挑战；对很多公司来说，这是一项势在必行的任务。本系列将带领读者走过一段旅程，从为API确定业务用例到设计方法论，解决实现难题，并从长远的角度看待在Web上维护公共API。沿途将会有对有影响力的人物的访谈，甚至还有API及相关主题的推荐阅读清单。这篇InfoQ...
为什么应该首选声明式API设计而不是命令式设计？
在本文中，声明性API得到更广泛使用的主要原因之一是，与命令性API相比，声明性API的使用更加简洁，并且提供了更好的抽象性。
API设计规范
RestfulAPI设计指南接下来我将介绍RESTfulAPI的设计细节，探讨如何设计一套合理、好用的API一、协议API与用户的通信协议，总是使用HTTPs协议。二、域名应该尽量将API部署在专用域名之下。https://api.example.com 如果确定API很简单，不会有进一步扩展，可以...
开发者必备——API设计问题
本文主要探讨RPC和RESTFul两种API风格的特点以及在开发中应该如何进行技术选型，同时截取了网上社区，文章一部分关于API设计的想法和观点供读者参考，取舍。1，背景简述API学名：应用程序接口（ApplicationProgrammingInterface）通俗的打个比方，人与人之间通过语言来...
朱晔的互联网架构实践心得S2E5：浅谈四种API设计风格（RPC、REST、GraphQL、服务端驱动）
WebAPI设计其实是一个挺重要的设计话题，许多公司都会有公司层面的WebAPI设计规范，几乎所有的项目在详细设计阶段都会进行API设计，项目开发后都会有一份API文档供测试和联调。本文尝试根据自己的理解总结一下目前常见的四种API设计风格以及设计考虑点。RPC这是最常见的方式，RPC说的是本地调用...
移动App的REST API设计实践
原文：http://www.jianshu.com/p/23cccb3a90b1通讯协议一些只是对服务器数据进行CRUD操作的App，通常采用HTTP协议，为了安全也可以采用HTTPS协议。IM软件可以选择使用XMPP协议。其他一些特有场景的App可能基于Socket自定义协议。SOCKET是实现传...
REST API设计指导——译自Microsoft REST API Guidelines（二）
由于文章内容较长，只能拆开发布。翻译的不对之处，请多多指教。另外：最近团队在做一些技术何架构的研究，视频教程只能争取周末多录制一点，同时预计在下周我们会展开一次直播活动，内容围绕容器技术这块。所有章节我们翻译校对完成后，将会将最终定稿签入到我们的Github开源库托管，方便大家查阅和校正。同时，我们...
REST API设计指导——译自Microsoft REST API Guidelines（一）
前言前面我们说了，有章可循，有据可依，有正确的产品流程和规范，我们的工作才不至于产生混乱，团队的工作才能更有成效。我们经常见到，程序开发可能只用了半个月，但是接口的联调却经常需要花费半个月甚至一个月左右。如果API的设计更规范更合理，在很大程度上能够提高联调的效率，降低沟通成本。那么什么是好的API...
API设计和命名
1.前言对于前端开发而言，肯定会和API打交道，大家也都会想过怎么设计自己的API。优秀的API之于代码，就如良好内涵对于每个人。好的API不但利于使用者理解，开发时也会事半功倍，后期维护更是顺风顺水。至于怎么设计API，今天就提下我自己的一些建议。如果大家有什么好的想法，欢迎指点。2.命名良好的一...
REST API设计指导——译自Microsoft REST API Guidelines（四）
前言前面我们说了，如果API的设计更规范更合理，在很大程度上能够提高联调的效率，降低沟通成本。那么什么是好的API设计？这里我们不得不提到RESTAPI。关于RESTAPI的书籍很多，但是完整完善实践丰富的设计指导并不多见，我们有幸看到了微软团队的作品——MicrosoftRESTAPIGuidel...
javascript的api设计原则
前言本篇博文来自一次公司内部的前端分享，从多个方面讨论了在设计接口时遵循的原则，总共包含了七个大块。系卤煮自己总结的一些经验和教训。本篇博文同时也参考了其他一些文章，相关地址会在后面贴出来。很难做到详尽充实，如果有好的建议或者不对的地方，还望不吝赐教斧正。一、接口的流畅性好的接口是流畅易懂的，他主要...
移动互联网实战--Web Restful API设计和基础架构
前言:在移动互联网的大潮中,WebRestfulAPI逐渐成为WebServer重要的一个分支.移动端和服务端的交互,主流的方式还是通过Http协议的形式来进行.请求以Get/Post方式,响应以json(数据更小巧且自描述能力强)的方式占据主流.各大互联网公司,对自身的WebApi设计有各自的标准...
REST API设计指导——译自Microsoft REST API Guidelines（三）
前面我们说了，如果API的设计更规范更合理，在很大程度上能够提高联调的效率，降低沟通成本。那么什么是好的API设计？这里我们不得不提到RESTAPI。关于RESTAPI的书籍很多，但是完整完善实践丰富的设计指导并不多见，我们有幸看到了微软团队的作品——MicrosoftRESTAPIGuidelin...
API设计中防重放攻击
标签：HTTPS数据加密是否可以防止重放攻击？否，加密可以有效防止明文数据被监听，但是却防止不了重放攻击。防重放机制我们在设计接口的时候，最怕一个接口被用户截取用于重放攻击。重放攻击是什么呢？就是把你的请求原封不动地再发送一次，两次...n次，一般正常的请求都会通过验证进入到正常逻辑中，如果这个正常...
Yii2 Restful api设计--App接口编程
Yii2框架写一套RESTful风格的API，对照魏曦教你学一，入门一、目录结构实现一个简单地RESTfulAPI只需用到三个文件。目录如下：frontend├─config│└main.php├─controllers│└BookController.php└─models└Book.php二、配...
GOTO Berlin: Web API设计原则
在邮件列表和讨论区中有很多与REST和WebAPI相关的讨论，下面仅是我个人对这些问题的一些见解，并没有绝对的真理，InnoQ的首席顾问OliverWolf在GOTOBerlin大会上开始自己的演讲“WebAPI设计原则”时如是说。不要考虑端点。SOAP有一个单独入口点的外观。相比之下Web有很多入...
我是如何根据豆瓣api来理解Restful API设计的
1.什么是RESTREST全称是RepresentationalStateTransfer,表述状态转移的意思。它是在RoyFielding博士论文首次提出。REST本身没有创造新的技术、组件或服务，它的理念就是在现有的技术之上，更好的使用现有的web规范。用REST规范的web服务器，能够更好的展...
App后台开发运维和架构实践学习总结（2）——RESTful API设计技巧
前言移动互联网时代，RESTfulAPI成为越来越重要的移动端和服务器端交互的形式。尤其是在很多互联网公司或者传统行业拥抱移动互联网的时候，一套设计良好的RestfulAPI能够帮助互联网产品支持单服务端＋多客户端的场景。RESTful架构本身是一个风格而不是一个标准，这也就意味着在具体设计时会有不...