wcode

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

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

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

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

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

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

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

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

限流与权限类似，因为它确定是否应该授权请求。 限流阀指示临时状态，并用于控制客户端可以对API进行的请求速率。 与权限一样，可能会使用多种限流方式。你的 API 可能对未经身份验证的请求进行限流，对经过身份验证的请求限流较少。 如果你需要对 API 的不同部分使用不同的限流策略…