…

REST API Design Guidelines V 1.0.201208 Draft 5 Last Updated: 08/31/2012 1       简介 本文档旨在规范REST API的设计和开发. 1.1      REST API目标 REST API允许Newegg内部和外部开发人员通过编程方式访问Newegg系统的各种对象与资源. REST API需最大限度地满足平台无关性. 2       REST基本原则 REST全称“Representational State Tr…

http://code.tutsplus.com/tutorials/restful-api-design-with-nodejs-restify--cms-22637 The RESTful API consists of two main concepts: Resource, and Representation. Resource can be any object associated with data, or identified with a URI (more than one…

RESTful API Design: 13 Best Practices to Make Your Users Happy First step to the RESTful way: make sure errors don't come back as 200 OK. Architect at work. Daniel McCullough, unsplash.com Web services have been around for as long as the HTTP protoco…

UPDATE: This post has been expanded upon and converted into an eBook. Good API design is hard! An API represents a contract between you and those who Consume your data. Breaking this contract will result in many angry emails, and a slew of sad users…

Effective API Design */--> div.org-src-container { font-size: 85%; font-family: monospace; } Table of Contents 1. Foreword 2. Process of API Design 3. General Principles 4. Classes Deisgn 5. Method Design 6. Exceptions Design 7. Refactoring API Desig…

[the original link] One of Qt’s most reputed merits is its consistent, easy-to-learn, powerfulAPI. This document tries to summarize the know-how we’ve accumulated on designing Qt-style APIs. Many of the guidelines are universal; others are more conve…

Atitit.index manager api design 索引管理api设计 1. kw 1 1.1. 索引类型 unique,normal,fulltxt 1 1.2. 聚集索引(clustered index,也称聚类索引 1 1.3. 索引方式:btree,hashtable 2 1.4. 索引使用所有的页面规模百分比 2 2. Ui 2 3. api 2 3.1. createIndex(indexName,cols) 2 3.2. Rebuild 2 3.3. Del 2 3.4…

Atitit.index manager api design 索引管理api设计 1. kw1 1.1. 索引类型 unique,normal,fulltxt1 1.2. 聚集索引(clustered index,也称聚类索引1 1.3. 索引方式:btree,hashtable2 1.4. 索引使用所有的页面规模百分比2 2. Ui2 3. api2 3.1. createIndex(indexName,cols)2 3.2. Rebuild2 3.3. Del2 3.4. Up2 4. -…

Web API design 28 minutes to read Most modern web applications expose APIs that clients can use to interact with the application. A well-designed web API should aim to support: Platform independence. Any client should be able to call the API, regardl…

面向资源的设计 这份设计指南的目标是帮助开发人员设计简单.一致.易用的网络API.同时,它也有助于收敛基于socket的API和(注:原文是with,这里翻译为“和”)基于HTTP的REST API. 以前,人们根据诸如CORBA和Windows COM这样的API接口和方法设计RPC API.随着时间的推移,接口和方法越来越多.最后,接口和方法数不胜数又各不相同.开发人员要正确使用它们,必须仔细了解每一个的用法,这很浪费时间而且容易出错. 2000年,为了与HTTP1.1搭配使用,REST架构…

  org.apache.hadoop.fs.FileSystem 是HDFS的文件系统抽象,在分布式系统中管理HDFS文件和目录.文件内容存储在由多个相同大小的块(如64M)构成的datanode节点中,namenode节点存储着这些块的信息和元信息.FileSystem按顺序访问这些块数据.FileSystem首先通过NameNode节点获取块信息,然后一个接一个地打开,读取,关闭.当FileSystem打开第一个块之后在完成读取后关闭之,然后打开第二个块.HDFS会对块数据进行多次复制以获…

…

https://restful-api-design.readthedocs.org/en/latest/scope.html http://blog.mashape.com/30-ways-to-make-rest-calls-in-node-js-php-python/ http://blog.mashape.com/list-of-40-tutorials-on-how-to-create-an-api/ 版权声明:本文为博主原创文章,未经博主允许不得转载.…

前谷歌首席 Java 架构师谈如何设优秀的 API – 码农网 http://www.codeceo.com/article/google-java-good-api.html 2015-11-24    分类:JAVA开发.编程开发.首页精华2人评论     来源:CSDN 分享到:更多10 随着近来软件规模的日益庞大,API编程接口的设计变的越来越重要.良好的接口设计可以降低系统各部分之间的相互依赖,提高组成单元的内聚性,降低组成单元间的耦合度,从而提高系统的维护性和稳定性. Joshua…

原文:http://www.thebuzzmedia.com/designing-a-secure-rest-api-without-oauth-authentication/ Situation You want to develop a RESTful web API for developers that is secure to use, but doesn’t require the complexity of OAuth and takes a simple “pass the cr…

Introduction Almost all successful internet based companies have APIs. API is an acronym for Application Programming Interface. APIs allows different systems to communicate with one another. Let’s say you have developed an android application for our…

[Framework Design Guideline]基础知识 最近在读<Framework design guideline>, 感觉其中Framework的许多设计经验同样适用于业务类库的设计,甚至对于服务的设计也同样适用. 日常的设计和编码中,书中提到的许多原则也有所领悟,但一直无法系统的组织起来. 所以此文把这些指导经验都整理起来,一作为备忘,二也是为这些平常只能靠感觉的东西建立成文的指导.本文只整理了一些对于业务应用类库开发更有用的原则. 一.什么是好的设计 Well-Design…

With the rise of mobile development and JavaScript frameworks, using a RESTful API is the best option to build a single interface between your data and your client. Laravel is a PHP framework developed with PHP developer productivity in mind. Written…

使用HTTP Status区分不同消息返回 最基础的三个状态200 OK, 400 Client Error, 500 Server Error 这些应该是够的, 如果客户端可以处理更细的划分, 可以细分为:200 OK,  201 Created, 304 Not Modified, 400 Client Error, 401 Unauthorized, 403 Forbidden, 404 Not Found, 500 Server Error 定义基础错误信息结构 { "status&qu…

http://apievangelist.com/2014/10/05/taking-a-fresh-look-at-what-open-source-api-management-architecture-is-available/ 05 Oct 2014 I’ve been a outspoken advocate for more open source API management tooling, for some time now. I'm sensitive to the fact…

本文翻译自The Flask Mega-Tutorial Part XXIII: Application Programming Interfaces (APIs) 我为此应用程序构建的所有功能都只适用于特定类型的客户端:Web浏览器. 但其他类型的客户端呢? 例如,如果我想构建Android或iOS APP,有两种主流方法可以解决这个问题. 最简单的解决方案是构建一个简单的APP,仅使用一个Web视图组件并用Microblog网站填充整个屏幕,但相比在设备的Web浏览器中打开网站,这种方案几乎…

概要 本文是学习B站毛剑老师的<API 工程化分享>的学习笔记,分享了 gRPC 中的 Proto 管理方式,Proto 分仓源码方式,Proto 独立同步方式,Proto git submodules 方式,Proto 项目布局,Proto Errors,服务端和客户端的 Proto Errors,Proto 文档等等 目录 Proto IDL Management IDL Project Layout IDL Errors IDL Docs Proto IDL Management Pro…

Web APIs has become an very important topic in the last year. We at M-Way Solutions are working every day with different backend systems and therefore we know about the importance of a clean API design. Typically we use a RESTful design for our web A…

相关文章:RESTful API URI 设计的一些总结. 问题场景:删除一个资源(Resources),URI 该如何设计? 应用示例:删除名称为 iPhone 6 的产品. 是不是感觉很简单呢?根据应用示例,我们用代码实现下: public class ProductsController : ApiController { [HttpDelete] [Route("api/products")] public async Task<HttpResponseMessage&g…

相关的一篇文章:RESTful API URI 设计的一些总结. 问题场景:判断一个资源(Resources)是否存在,URI 该如何设计? 应用示例:判断 id 为 1 用户下,名称为 windows 10 的产品是否存在? 如果这个问题出现在 MVC 项目中,我想我们一般会这样设计: public class ProductService { public async Task<bool> IsExist(int userId, string productName) { .... } }…

How polygons are handled internally The five basic polygonal API classes Construction History and Tweaks polyModifierCmd example splitUVCmd example Poly exporter plug-ins 用来存储polygon(faces,edges,vertices)等部分的基本数据结构,这些数据结构然后被封装到polygonal shape nodes,这…

我们从API的功能.分类.设计.实现.用户来看什么是API. API是应用程序组件之间通信的接口 --wiki:Application Programming Interface In computer programming, an application programming interface (API) is a set of subroutine definitions, protocols, and tools for building application software.…

pingback :http://java.sys-con.com/node/84633?page=0,1 Object-oriented design is like an alloy consisting of a solid grounding in the object-oriented (OO) approach and implementing the best OO practices heavily laced with how to sidestep the OO pitfal…

网络应用程序,分为前端和后端两个部分.当前的发展趋势,就是前端设备层出不穷(手机.平板.桌面电脑.其他专用设备......). 因此,必须有一种统一的机制,方便不同的前端设备与后端进行通信.这导致API构架的流行,甚至出现"API First"的设计思想.RESTful API是目前比较成熟的一套互联网应用程序的API设计理论.我以前写过一篇<理解RESTful架构>,探讨如何理解这个概念. 今天,我将介绍RESTful API的设计细节,探讨如何设计一套合理.好用的API…