Menu

2.5. Github 的 Restful HTTP API 设计分解

什么是 RESTful

RESTful 是一种软件设计风格,由 Roy Fielding 在他的 论文 中提出,全称为 Representational State Transfer,直译为表现层状态转移,或许可以解释为用 URL 定位资源,用 HTTP 动词描述操作,不用太纠结于定义,接下来我们会详细讨论。

RESTful 风格的接口,目前来看,实现的最好的就是 Github API,经常被效仿。接下来我们通过分析 Github API 来引出我们的 API 设计原则。

为什么选择 RESTful

我认为一套接口应该尽量满足以下几个原则:

  • 安全可靠,高效,易扩展。
  • 简单明了,可读性强,没有歧义。
  • API 风格统一,调用规则,传入参数和返回数据有统一的标准。

我们当然可以根据自己的经验,或者参考知名公司的接口总结设计出一套满足要求的接口,但是每个人对接口的理解不同,设计出来的接口也会有所不同,接口的命名,请求参数的格式,响应的结果,错误响应的错...

本文章首发在 LearnKu.com 网站上。

为了保证课程的高品质,我们需要对课程进行收费。付费后 才能观看剩余内容。 购买

上一篇 下一篇
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
讨论数量: 5

Bennent_G
响应格式 xml 问题 ?
2 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
Soldoros
为什么非 HTTPS 的 API 调用,不重定向而直接返回错误?
1 个点赞 | 4 个回复 | 问答 | 课程版本 5.5
喜鸥得逸
API 多版本的目录设置问题
1 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
monch
接口跨域的时候呢
0 个点赞 | 4 个回复 | 问答 | 课程版本 5.5
wiladog
dingo API 自定义数据响应格式?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
刻意练习,每日精进。
3
点赞
5375
浏览
5
讨论
贡献者