好奇哈米说

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

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

REST framework 包含一个可配置的机制，用于确定 API 如何响应 OPTIONS 请求。这使你可以返回 API schema 或其他资源信息。 对于 HTTP OPTIONS 请求应该返回哪种风格的响应，目前还没有任何被广泛采用的约定，所以我们提供了一种专门的风格…

REST framework 包含对可定制分页样式的支持。这使你可以将较大的结果集分成单独的数据页面。 以分页链接的形式作为响应内容的一部分。 以分页链接的形式包含在响应的 header 中，如 Content-Range 或 Link. 内置的样式目前是以分页链接的形式作为响…

身份验证是将传入请求与一组识别凭证（例如请求的用户或其签名的令牌）相关联的机制。然后，权限和限制策略可以使用这些凭据来确定请求是否应该被允许。 REST framework 提供了许多开箱即用的身份验证方案，同时也允许你实施自定义方案。 身份验证始终在视图的开始处运行，在执行权…

REST framework 的通用列表视图的默认行为是从模型管理器返回整个查询集。通常你会希望 API 限制查询集返回的条目。 筛选 GenericAPIView 子类的查询集的最简单方法是重写 .get_queryset() 方法。 重写此方法允许你以多种不同方式自定义视图…

Web API 的常见模式是在 URL 上使用文件扩展名来为给定的媒体类型提供端点。 例如，'http://example.com/api/users.json' 用于提供 JSON 表示。 在 URLconf 中为你的 API 添加 format-suffix 模式是容易出错…

通常，从 Web API（例如 http://example.com/foobar）返回绝对 URI 可能是更好的做法，而不是返回相对 URI，例如 /foobar。 它更明确。 它为你的 API 客户端留下更少的工作。 当字符串在诸如 JSON 这样的表示中没有本地 URI …

REST framework 的视图处理各种异常，并返回适当的错误响应。 在 REST framework 内引发的 APIException的子类。 Django 的 Http404 异常。 Django 的 PermissionDenied 异常。 在每种情况下，REST …