Third Party Packages

# 第三方包 (Third Party Packages) *软件生态系统 […] 建立一个社区，进一步加速知识、内容、问题、专业知识和技能的共享。—— [Jan Bosch](http://www.software-ecosystems.com/Software_Ecosystems/Ecosystems.html)* ## 关于第三方包 (About Third Party Packages) 第三方软件包允许开发人员共享扩展 Django REST framework 功能...

阅读全文>>

2018年10月8日 23:36 作者：nancy 分类：[Django] 1574

REST, Hypermedia & HATEOAS

# REST, Hypermedia & HATEOAS *你一直用 “REST” 这个词。我不认为这意味着你认为它意味着什么。—— Mike Amundsen，[REST fest 2012主题演讲](https://vimeo.com/channels/restfest/page:2)。* 首先，免责声明。“Django REST framework ” 这个名称早在 2011 年初就已经确定，之所以选择这个名称只是为了确保开发人员能够轻松找到该项目。在整个文档中，我们尝试使用...

阅读全文>>

2018年10月7日 13:55 作者：nancy 分类：[Django] 1501

The Browsable API

# 可浏览的 API (The Browsable API) *这是一个极其错误的真理……我们应该培养思考我们正在做什么的习惯。事实恰恰相反。文明的进步是通过扩展我们不需要思考就能完成的重要操作的数量。—— [Alfred North Whitehead](https://en.wikiquote.org/wiki/Alfred_North_Whitehead)，数学概论 (1911)* API 可能代表应用程序编程接口，但是人类也必须能够读取 API；必须有人进行编程。Djang...

阅读全文>>

2018年10月6日 23:13 作者：nancy 分类：[Django] 1662

HTML & Forms

# HTML 和表单 (HTML & Forms) REST framework 适用于返回 API 样式响应和常规 HTML 页面。此外，序列化器可用作 HTML 表单并在模板中渲染。 ## 渲染 HTML (Rendering HTML) 为了返回 HTML 响应，您需要使用 `TemplateHTMLRenderer` 或 `StaticHTMLRenderer`。 `TemplateHTMLRenderer` 类期望响应包含上下文数据的字典，并基于必须在视图或响应中...

阅读全文>>

2018年10月5日 20:26 作者：nancy 分类：[Django] 1664

Browser Enhancements

# 浏览器增强 (Browser enhancements) *“重载 POST 有两个无争议的用途。第一种是为不支持 PUT 或 DELETE 的 Web 浏览器等客户端模拟 HTTP 的统一接口” —— [RESTful Web Services](https://www.amazon.com/RESTful-Web-Services-Leonard-Richardson/dp/0596529260), Leonard Richardson & Sam Ruby.* 为了让可浏...

阅读全文>>

2018年10月3日 17:42 作者：nancy 分类：[Django] 1354

AJAX, CSRF & CORS

# 使用 AJAX，CSRF 和 CORS (Working with AJAX, CSRF & CORS) *“仔细查看您自己网站上可能存在的 CSRF / XSRF 漏洞。它们是最糟糕的一种漏洞——很容易被攻击者利用，但对软件开发人员来说却不那么直观易懂，至少在您被攻击之前是这样。” —— [Jeff Atwood](https://blog.codinghorror.com/preventing-csrf-and-xsrf-attacks/)* ## Javascript 客...

阅读全文>>

2018年10月1日 23:50 作者：nancy 分类：[Django] 1543

Internationalization

# 国际化 (Internationalization) *支持国际化不是可选的。它必须是核心功能。—— [Jannis Leidel，2015 年在 Django Under the Hood 演讲](https://youtu.be/Wa0VfS2q94Y)。* REST framework 附带可翻译的错误消息。您可以启用 [Django 的标准翻译机制](https://docs.djangoproject.com/en/1.7/topics/i18n/translatio...

阅读全文>>

2018年9月30日 18:20 作者：nancy 分类：[Django] 1910

API Clients

# API 客户端 (API Clients) API 客户端处理网络请求是如何发出的以及如何解码响应的底层细节。它们为开发人员提供了一个应用程序接口来工作，而不是直接与网络接口一起工作。 此处记录的 API 客户端不限于使用 Django REST framework 构建的 API。它们可以与任何公开支持的模式格式的 API 一起使用。 例如，[Heroku 平台 API](https://devcenter.heroku.com/categories/platform-...

阅读全文>>

2018年9月25日 17:58 作者：nancy 分类：[Django] 1839

Documenting your API

# 记录您的 API (Documenting your API) *REST API 应该花费几乎所有的描述性工作来定义用于表示资源和驱动应用程序状态的媒体类型。—— Roy Fielding, [REST APIs must be hypertext driven](http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven)* REST framework 提供对 API 文档的内置支持。还有一些...

阅读全文>>

2018年9月21日 16:16 作者：nancy 分类：[Django] 2803

Django REST framework 中文翻译文档

# Django REST framework 中文文档 如果本文对您有所帮助，请在 [github](https://github.com/fangweiren/Django-REST-framework-documentation) 上 **star** 该项目。 ## 版本说明 这是 Django REST framework v3 版本的中文翻译文档。 - djangorestframework v3.8.2 - django 2.0.6 - python 3....

阅读全文>>

2018年9月5日 14:53 作者：nancy 分类：[Django] 1895