API schema 是一个非常有用的工具，它允许一系列用例，包括生成参考文档，或者驱动可以与 API 交互的动态客户端库。 你需要安装 coreapi 软件包才能为 REST framework 添加 schema 支持。 REST framework 使用 Core API…

内容协商是基于客户端或服务器偏好选择多种可能的表示之一以返回客户端的过程。 REST framework 根据可用的渲染器，每个渲染器的优先级以及客户端的 Accept: header，使用简单的内容协商风格来确定应将哪些媒体类型返回给客户端。所使用的风格部分由客户端驱动，部分…

REST framework 包含许多内置的渲染器类，允许您使用各种 media type 返回响应。同时也支持自定义渲染器。 视图的渲染器集合始终被定义为类列表。当调用视图时，REST framework 将对请求内容进行分析，并确定最合适的渲染器以满足请求。内容分析的基本过…

REST framework 包含许多内置的解析器类，允许接受各种媒体类型（media types）的请求。还支持自定义解析器，这使你可以灵活地设计 API 接受的媒体类型。 视图的有效解析器集始终定义为类列表。当访问 request.data 时，REST framework…

API 版本控制允许你更改不同客户端之间的行为。 REST framework 提供了许多不同的版本控制方案。 版本控制由传入的客户端请求决定，可能基于请求 URL 或请求 header。 有几种有效的方法来处理版本控制。非版本化的系统也可能是合适的，特别是如果你正在为超出控制…

REST framework 的 Request 类扩展与标准的 HttpRequest，并做了相应的增强，比如更加灵活的请求解析（request parsing）和认证（request authentication）。 REST framwork 的 Request 对象提供…

不建议在你的响应中使用裸露（直接使用数字）的状态码。 REST framework 包含一组命名常量，你可以使用它们使代码更加清晰易读。 下面列出了 status 模块中包含的全部 HTTP 状态码。 该模块还包含一组帮助函数，用于测试状态码是否在给定范围内。 这类状态码表示临…

大多数情况下，您在 REST framework 中处理验证时，只需依赖默认的字段验证，或者在序列化类或字段类上编写明确的验证方法。 但是，有时你会希望将验证逻辑放置到可重用组件中，以便在整个代码库中轻松地重用它。这可以通过使用验证器函数和验证器类来实现。 Django RES…

序列化器允许将诸如查询集和模型实例之类的复杂数据转换为原生 Python 数据类型，然后可以将它们轻松地呈现为 JSON，XML 或其他内容类型。序列化器还提供反序列化，在首次验证传入数据之后，可以将解析的数据转换回复杂类型。 REST framework 中的序列化类与 Dj…