课程章节:5-3 RESTFul API 的最佳实践,5-4 如何学习 RESTFul API 设计
课程讲师: 7七月
课程内容:
今天学习的内容主要是 RESTFul API 的设计与最佳实践,具体概括如下:
状态码:
404:资源未找到
400:参数错误
200:一个查询操作GET请求成功了
201:一个POST创建资源成功了
202:PUT更新成功了(不同的API对202设置可能不同)
401:未授权,
403:未授权,当前资源被禁用 (A用户操作B用户的资源时)
500:服务器的未知错误。(1、确实不知道,2、知道,但是服务器的错误不想让用户知道)
错误码:自定义的错误ID号
统一描述错误:错误码、错误信息、当前URL
RESTFul API 应该合理使用,按需设计,切勿盲目照搬标准 REST。RESTFul API 更适合开放 API。学习 RESTFul API 的最佳方式就是模仿,例如参考豆瓣开放 API。
课程收获:
今天从七月老师的课程中学到了 RESTFul API 的设计与最佳实践。不过不是所有 API 的设计都要照搬 RESTFul API 模式,适合的才是最好的。今天学完了第五章,开始学第六章,学了六个小节,比昨天进步较大。篇幅有限这篇手记只选取了前两节,明日再续。
今日课程学习时间大约花费 27 分钟。