Django REST FrameWork中文教程7:模式和客户端库
模式是一种机器可读文档,用于描述可用的API端点,其URLS以及它们支持的操作。 模式可以是自动生成的文档的有用工具,也可以用于驱动可以与API进行交互的动态客户端库。 核心API为了提供模式支持REST框架使用Core API。 Core API是用于描述API的文档规范。它用于提供可用端点的内部表示格式以及API暴露的可能交互。它可以用于服务器端或客户端。 当使用服务器端时,Core API允许API支持各种模式或超媒体格式的渲染。 当客户端使用时,Core API允许动态驱动的客户端库可以与暴露支持的模式或超媒体格式的任何API进行交互。 添加模式REST框架支持明确定义的模式视图或自动生成的模式。由于我们使用的是视图和路由器,我们可以简单地使用自动模式生成。 您需要安装 $?pip?install?coreapi 现在我们可以通过在URL配置中包含一个自动生成的模式视图来为API添加模式。 from?rest_framework.schemas?import?get_schema_view schema_view?=?get_schema_view(title='Pastebin?API') urlpatterns?=?[ ????url(r'^schema/$',?schema_view),????... ] 如果您在浏览器中访问API根端点,则现在应该可以看到 我们还可以通过在 $?http?http://127.0.0.1:8000/schema/?Accept:application/coreapi+json HTTP/1.0?200?OK Allow:?GET,?HEAD,?OPTIONS Content-Type:?application/coreapi+json { ????"_meta":?{ ????????"title":?"Pastebin?API" ????},????"_type":?"document",????... 默认输出样式是使用Core JSON编码。 还支持其他架构格式,如Open API(以前称为Swagger)。 使用命令行客户端现在我们的API暴露了架构端点,我们可以使用动态客户端库来与API进行交互。为了证明这一点,我们来使用Core API命令行客户端。 命令行客户端可用作 $?pip?install?coreapi-cli 现在检查它在命令行上可用... $?coreapi Usage:?coreapi?[OPTIONS]?COMMAND?[ARGS]... ??Command?line?client?for?interacting?with?CoreAPI?services. ??Visit?http://www.coreapi.org?for?more?information. Options: ??--version??Display?the?package?version?number. ??--help?????Show?this?message?and?exit. Commands: ... 首先,我们将使用命令行客户机加载API模式。 $?coreapi?get?http://127.0.0.1:8000/schema/ <Pastebin?API?"http://127.0.0.1:8000/schema/"> ????snippets:?{ ????????highlight(id) ????????list() ????????read(id) ????} ????users:?{ ????????list() ????????read(id) ????} 我们还没有认证,所以现在我们只能看到只读端点,这与我们如何设置API的权限一致。 我们尝试列出现有的片段,使用命令行客户端: $?coreapi?action?snippets?list [ ????{ ????????"url":?"http://127.0.0.1:8000/snippets/1/",????????"id":?1,????????"highlight":?"http://127.0.0.1:8000/snippets/1/highlight/",????????"owner":?"lucy",????????"title":?"Example",????????"code":?"print('hello,?world!')",????????"linenos":?true,????????"language":?"python",????????"style":?"friendly" ????},????... 一些API端点需要命名参数。例如,要获取特定代码段的高亮度HTML,我们需要提供一个id。
$?coreapi?action?snippets?highlight?--param?id=1 <!DOCTYPE?html?PUBLIC?"-//W3C//DTD?HTML?4.01//EN"?"http://www.w3.org/TR/html4/strict.dtd"> <html> <head> ??<title>Example</title> ??...
认证我们的客户如果我们想要创建,编辑和删除片段,我们需要作为有效用户进行身份验证。在这种情况下,我们只需使用基本的auth。 确保更换 $?coreapi?credentials?add?127.0.0.1?<username>:<password>?--auth?basic Added?credentials 127.0.0.1?"Basic?<...>" 现在,如果我们再次获取架构,我们应该能够看到一整套可用的交互。 $?coreapi?reload Pastebin?API?"http://127.0.0.1:8000/schema/"> ????snippets:?{ ????????create(code,?[title],?[linenos],?[language],?[style]) ????????delete(id) ????????highlight(id) ????????list() ????????partial_update(id,?[code],?[style]) ????????read(id) ????????update(id,?code,?[style]) ????} ????users:?{ ????????list() ????????read(id) ????} 我们现在可以与这些端点进行交互。例如,要创建新的代码段: $?coreapi?action?snippets?create?--param?title="Example"?--param?code="print('hello,?world')" { ????"url":?"http://127.0.0.1:8000/snippets/7/",????"id":?7,????"highlight":?"http://127.0.0.1:8000/snippets/7/highlight/",????"owner":?"lucy",????"title":?"Example",????"code":?"print('hello,?world')",????"linenos":?false,????"language":?"python",????"style":?"friendly" } 并删除片段: $?coreapi?action?snippets?delete?--param?id=7
除了命令行客户端,开发人员还可以使用客户端库与您的API进行交互。Python客户端库是第一个可用的,并且计划很快发布一个Javascript客户端库。 有关定制模式生成和使用Core API客户端库的更多详细信息,您需要参考完整的文档。 我们拥有非常少量的代码,现在拥有一个完整的可以浏览网页的完整的pastebin Web API,它包含一个模式驱动的客户端库,并且具有身份验证,每个对象权限和多个渲染器格式。 我们已经走过了设计过程的每一步,并且看到了如何自定义任何我们可以逐渐工作的方式来简单地使用常规的Django视图。 您可以查看GitHub上的最终教程代码,或者尝试沙盒中的实例。 我们已经完成了我们的教程。如果您想要更多地参与到REST框架项目中,以下是您可以开始的几个地方: 通过审查和提交问题,提出请求,为GitHub做出贡献。 加入REST框架讨论组,并帮助构建社区。 跟随Twitter上的作者,并说你好。 现在去构建真棒的东西。 Django REST FrameWork中文文档目录: Django REST FrameWork 中文教程1:序列化 Django REST FrameWork 中文教程2:请求和响应 Django REST FrameWork 中文教程3:基于类的视图 Django REST FrameWork 中文教程4:验证和权限 Django REST FrameWork 中文教程5:关系和超链接API Django REST FrameWork 中文教程6: ViewSets&Routers Django REST FrameWork 中文教程7:模式和客户端库 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |