# REST API [TOC=2,3] 项目中，经常要提供一个 API 供第三方使用，一个通用的 API 设计规范就是使用 REST API。REST API 是使用 HTTP 中的请求类型来标识对资源的操作。如： * `GET` `/ticket` #获取ticket列表 * `GET` `/ticket/12` #查看某个具体的ticket * `POST` `/ticket` #新建一个ticket * `PUT` `/ticket/12` #更新ticket 12 * `DELETE` `/ticket/12` #删除ticekt 12 ThinkJS 中提供了很便捷的方式来创建 REST API，创建后无需额外的代码即可响应 REST API 的处理，同时也可以通过定制响应额外的需求。 ## 创建 REST API 通过 `thinkjs controller [name] --rest` 即可创建一个 REST API。如： ~~~ thinkjs controller home/ticket --rest ~~~ 上面的命令表示在 `home` 模块下创建了一个 `ticket` 的 Rest Controller，该 Controller 用来处理资源 `ticket`的请求。 ## 处理 REST API 请求 Rest Controller 创建完成后，无需写任何的代码，即可完成对 REST API 的处理。资源名称和数据表名称是一一对应的，如：资源名为 `ticket`，那么对应的数据表为 `数据表前缀` + `ticket`。 ## 请求类型 REST API 默认是从 HTTP METHOD 里获取当前的请求类型的，如：当前请求类型是 `DELETE`，表示对资源进行删除操作。 如果有些客户端不支持发送 `DELETE` 请求类型，那么可以通过属性 `_method` 指定一个参数用来接收请求类型。如： ~~~ export default class extends think.controller.rest { init(http){ super.init(http); this._method = "_method"; //指定请求类型从 GET 参数 _method 里获取 } } ~~~ ## 字段过滤 默认情况下，获取资源信息时，会将资源的所有字段都返回。有时候需要隐藏部分字段，可以通过在`__before` 魔术方法里完成此类操作。 ~~~ export default class extends think.controller.rest { __before(){ this.modelInstance.fieldReverse("password,score"); //隐藏 password 和 score 字段 } } ~~~ ## 权限管理 有些 REST API 需要进行权限验证，验证完成后才能获取对应的信息，可以通过在 `__before` 魔术方法里进行验证。 ~~~ export default class extends think.controller.rest { * __before(){ let auth = yield this.checkAuth(); if(!auth){ return this.fail("no permissions"); //没权限时直接返回 } } } ~~~ ## 更多定制 更多定制方式请参见 [API -> controller.rest](https://thinkjs.org/zh-CN/doc/2.0/api_controller_rest.html)。