　　只知道遵规循矩的程序员是假程序员，任何技术都是不断发明创造改进的。

　　如何设计处优秀的Restful API? 盲目跟风，设计糟糕的Resful API = 浪费时间 !

　　不啰嗦，直接进入技术主题：

　　1、REST API里面的术语

　　　　Resource (资源) ：就是数据，是对象，或者说物质

　　　　operation(操作)：这个概念是我个人抽出来的，很多人学Restful是没有这个概念，大家只知道资源，我个人认为有资源就有对资源的操作，例如http的方法： GET、POST、DELETE、PUT

　　　　Collections(集合)：就是一组资源

　　　　URL(统一资源定位符)：就是资源定位符，因为是通用，所以叫统一资源定位符。说白了可以理解为网址，就是资源的位置，比如一个图片地址、一个文件的地址、一部电影的地址

　　2、URL设计使用合适的词语（名词或者动词）

　　　　名词：对资源的表达、形容

　　　　动词：对资源的操作，其中基本的操作方法Http方法（GET、POST、DELETE、PUT）已经包含，所以URL的动词很少，能抽象出http的方法就尽量，不能抽象则在URL中表达（可参照关于restful开发的疑惑）

　　　　全部用小写

　 3、使用JSON作为通信格式

　　　　JSON的特性在此不详细说明

　　4、响应状态

　　　　一个状态码和一个消息就够了

　　　　状态码使用HTTP状态码，消息根据业务或者系统情况给合适的消息，不需再设计个什么 success 字段为true 或 false,有状态码了这是多此一举。
　　　　

/**

 * 统一码

 *

 * @author 尘无尘

 *

 */

public interface UnifiedCode {

    /**

     * 成功

     */

    static final int SUCCESS = 200;

    /**

     * 参数错误，虽然请求成功，但是请求参数错误 导致 无法调用接口或者无法正常执行接口

     */

    static final int PARAM_ERROR = 400;

    /**

     * 系统错误，虽然请求成功，但是由于系统内部问题导致无法正常处理请求

     */

    static final int SYS_ERROR = 500;

}