笔记介绍
- Web 利用前后端拆散构造
- Web API 接口设计的 RESTful 格调
- Django REST framework 框架
笔记获取的地址为:https://zhuanlan.zhihu.com/p/…
笔记目录:
意识 RESTful
在前后端拆散的利用模式里,后端 API 接口如何定义?
例如对于后端数据库中保留了商品的信息,前端可能须要对商品数据进行增删改查,那相应的每个操作后端都须要提供一个 API 接口:
- POST /add-goods 减少商品
- POST /delete-goods 删除商品
- POST /update-goods 批改商品
- GET /get-goods 查问商品信息
对于接口的申请形式与门路,每个后端开发人员可能都有本人的定义形式,格调迥异。
是否存在一种对立的定义形式,被宽广开发人员承受认可的形式呢?
这就是被广泛采纳的 API 的 RESTful 设计格调。
RESTful 设计办法
1. 域名
应该尽量将 API 部署在专用域名之下。
https://api.example.com
如果确定 API 很简略,不会有进一步扩大,能够思考放在主域名下。
https://example.org/api/
2. 版本(Versioning)
应该将 API 的版本号放入 URL。
http://www.example.com/api/1.0/foo
http://www.example.com/api/1.1/foo
http://www.example.com/ap、/2.0/foo
另一种做法是,将版本号放在 HTTP 头信息中,但不如放入 URL 不便和直观。Github 采纳这种做法。
因为不同的版本,能够了解成同一种资源的不同表现形式,所以应该采纳同一个 URL。版本号能够在 HTTP 申请头信息的 Accept 字段中进行辨别(参见 Versioning REST Services):
Accept: vnd.example-com.foo+json; version=1.0
Accept: vnd.example-com.foo+json; version=1.1
Accept: vnd.example-com.foo+json; version=2.0
1. 装置 DRF
pip install djangorestframework
2. 增加 rest_framework 利用
咱们利用在 Django 框架学习中创立的 demo 工程,在 settings.py 的INSTALLED_APPS中增加 ’rest_framework’。
INSTALLED_APPS = [
...
'rest_framework',
]
接下来就能够应用 DRF 进行开发了。