RESTful API 接口设计整理。安全、URL 定义、查询参数（排序、过滤）、版本、Headers、状态码、响应主体、错误、缓存、API WIKI 文档要点等

在它提出十多年后的今天，REST 已经成为最重要的 Web 应用技术之一。随着所有技术朝着 API 方向发展，它的重要性有可能持续快速地增长。每门主要编程语言现在已经包含构建 RESTful Web 服务的框架。同样地，Web 开发者和架构师对 REST 和 RESTful 服务有一个清晰的理解是很重要的。这篇教程解释了 REST 架构，然后研究使用它构建通用地基于 API 的任务的细节。

本文首发于Gevin的博客 原文链接：RESTful 架构风格概述 未经Gevin授权，禁止转载 在移动互联网的大潮下，随着docker等技术的兴起，『微服务』的概念也越来越被大家接受并应用于实践，日益增多的web service逐渐统一于RESTful 架构风格，如果开发者对…

设计一套良好的 API 接口。 原文地址：服务端指南 | 良好的 API 设计指南 博客地址：http://blog.720ui.com/ 版本号 在 RESTful API 中，API 接口应该尽量兼容之前的版本。但是，在实际业务开发场景中，可能随着业务需求的不断迭代，现有的…

尽管安全性是应用程序的一个关键点，但是在开发中实施起来确实比较麻烦。更加麻烦的是，这个关键点通常不怎么受重视，实现的效果普遍的 low，而且受到诸多方面的掣肘。

往期「译见」系列文章在账号分享中持续连载，敬请查看~在往期「译见」系列的文章中，我们已经建立了业务逻辑、数据访问层和前端控制器, 但是忽略了对身份进行验证。随着 Spring Security 成为实际意义上的标准, 将会在在构建 Java web 应用程序的身份验证和授权时使…

本文首发于Gevin的博客 原文链接：RESTful API 编写指南 未经 Gevin 授权，禁止转载 基于一些不错的RESTful开发组件，可以快速的开发出不错的RESTful API，但如果不了解开发规范的、健壮的RESTful API的基本面，即便优秀的RESTful开…

为了更好的讨论规范带来的争议及问题，现已把该文档整理并开源到 github，关于大家补充及提 issue。 在通过 API 于后端服务通信的过程中，应该 使用 HTTPS 协议。 所有的 API 必须保持向后兼容，你 必须 在引入新版本 API 的同时确保旧版本 API 仍然可…