RESETful API设计最佳实践
请求规范
请求应该包含URL、HTTP方法、请求体等。
- URL使用名词,尽量使用复数;
- URL使用嵌套表示关联关系,如
/users/12/repos/5
; - 使用正确的方法:
GET/POST/PUT/DELETE
。
响应规范
- 如果是分页,应该包含当前页数和每一页的数量:
分页 page=2&per_page=100
; - 状态码:
2开头正确 3表示重定向 4表示客户端错误 5代表服务端错误
; - 错误处理:返回错误信息。
安全
- HTTPS
- 鉴权
- 限流:在HTTP头加上了字段记录请求次数,如果超过规定的额度就会报403的错误。
安装和使用KOA
npm init cnpm i koa --save
新建index.js
const Koa = require(‘koa‘); const app = new Koa(); ? app.use(()=>{ console.log("Hello world"); }) ? app.listen(3000);
运行node index.js
,打开http://localhost:3000/
页面显示Not Found
,在终端打印了Hello world
。
认识中间件
修改上面的例子为下:
const Koa = require(‘koa‘); const app = new Koa(); const test = ()=>{ console.log("Hello world"); } app.use(test); app.listen(3000);
重新运行node index.js
,刷新网页,结果还是一样。这里app.use()
的内容就是中间件。我们可以使用多个中间件,使用多个中间件的时候我们需要使用next
。
const Koa = require(‘koa‘); const app = new Koa(); ? const test1 = (ctx,next)=>{ console.log("Hello world"); next(); } ? const test2 = (ctx,next)=>{ console.log("Hello China"); next(); } ? app.use(test1); app.use(test2); ? app.listen(3000);
ctx
是上下文,next
执行下一个中间件。打印结果:
Hello world Hello China
ctx
的理解:ctx
可以帮助你在多个中间件流转数据。
// 在test1中间件中 ctx.str = ‘Hello world‘; // 在test2中间件中可以读取 console.log(ctx.str);
自动更新nodemon
每次修改完代码又要重新启动很影响效率。
cnpm i nodemon --save-dev
以后运行就直接nodemon
+文件名
nodemon index.js
简化命令,在package.json
的script
新增命令
"start":"nodemon index.js"
运行npm start
即可。
原文地址:https://www.cnblogs.com/armouy/p/12238484.html
时间: 2024-10-11 11:34:24