前端、甚至大前端发展如此火爆的 2017 年（我相信 2018 年一样）刚过去，像 MVC 架构那样直接使用后端模板渲染前端页面的方式已经不被推崇了（当然有些场景下还是蛮适合的），交互的体验和难度都已经和 MVVM 架构的 Front-End 相差了 108000 Km -- 用户体验差，开发难度还高。现在是 VueJS / ReactJS / AngularJS 与使用 JSON 格式的 Back-End 交换数据的世界。作为一个 Django 使用者，DRF（Django Rest Framework，后面使用简称）也理所当然的变成
Django 开发者必学的一个 Package。
这篇文章我简单介绍一下 DRF 3.6 的两个新特性
1. 内置交互式API文档支持（Built-in interactive API documentation support）
新的 DRF API 交互式文档支持许多功能：
- 实时 API 交互。
- 支持各种认证方案。
- Python，JavaScript 和 Command Line 客户端的代码片段。
依赖或可选的 Package：
coreapi Package 是本特性的依赖项，确保安装最新版本哦（2.3.0 或更高版本）pygments Package 编程代码高亮（可选） markdown Package markdown 语法高亮（可选）
要生效 API 交互文档特性，您仅需要这样将其包含在项目 URLconf 中：
from rest_framework.documentation import include_docs_urls
API_TITLE = 'API title'
API_DESCRIPTION = '...'
urlpatterns = [
...
url(r'^docs/', include_docs_urls(title=API_TITLE,
description=API_DESCRIPTION))
]
2. 一个新的 JS 客户端库（A new JavaScript client library）
新的 JavaScript 客户端库允许您加载一种新的 API 模式，在应用程序层接口与该 API 交互，而不是显式构建提取请求（比如使用 axios 等前端类库）
下面是一个简短的例子，它演示了：
- 加载客户端库和模式。
- 实例化已认证的客户端。
- 使用客户端进行 API 请求。
<html>
<head>
<script src="/static/rest_framework/js/coreapi-0.1.0.js"></script>
<script src="/docs/schema.js"></script>
<script>
const coreapi = window.coreapi
const schema = window.schema
// Instantiate a client...
let auth = coreapi.auth.TokenAuthentication({scheme: 'JWT', token: 'xxx'})
let client = coreapi.Client({auth: auth})
// Make an API request...
client.action(schema, ['projects', 'list']).then(function(result) {
alert(result)
})
</script>
</head>
</html>
JavaScript 客户端库支持各种身份验证方案，可以由您的项目本身使用，也可以作为与 API 进行交互的外部客户端使用。
客户端不限于使用 REST 框架 API，尽管目前只支持加载 CoreJSON API 模式。后续将会计划支持 Swagger 和其他 API 模式。
有关更多详细信息，请参阅 JavaScript 客户端库文档。
--正文完--
转载请注明出处：zhuanlan.zhihu.com/p/33773485
如果大家觉得此类文章对你很有用，请务必点个关注，谢谢啦
文章不长，了解它们是为了解决什么问题就好，给大脑建个索引，能用上就去看文档，最后求关注
