REST API手册

WordPress REST API为应用程序提供了一个接口,通过以JSON格式(JavaScript对象表示法)对象。它是WordPress块编辑器,同样可以使您的主题、插件或自定义应用程序提供新的、强大的界面来管理和发布您的网站内容。

使用WordPress REST API,您可以创建一个插件,为WordPres提供全新的管理体验,构建全新的交互式前端体验,或将WordPress内容引入完全独立的应用程序。

REST API是WordPress面向开发人员的特性。它提供对站点内容的数据访问,并实施相同的身份验证限制——站点上公开的内容通常可以通过REST API公开访问,而私有内容、密码保护的内容、内部用户、自定义帖子类型、,和元数据只有通过身份验证或您专门设置为这样才可用。如果您不是开发人员,了解API最重要的一点是,它可以在不损害网站安全或隐私的情况下启用块编辑器和现代插件接口。

什么是REST API?

API是应用程序编程接口。REST代表“REpresentationalStateTransfer”,是一组概念,用于将应用程序的数据建模和访问为相互关联的对象和集合。WordPress REST API提供REST端点(URL),表示帖子、页面、分类和其他内置的WordPress数据类型。您的应用程序可以向这些端点发送和接收JSON数据,以便在您的站点上查询、修改和创建内容。JSON是一种开放的标准数据格式,它是轻量级的,并且是人类可读的,看起来像JavaScript中的Objects。当您从API请求内容或向API发送内容时,响应也将以JSON格式返回。由于JSON在许多编程语言中得到广泛支持,开发人员可以用客户端JavaScript(如块编辑器)、移动应用程序或桌面或命令行工具构建WordPress应用程序。

REST API只是WordPress提供的众多API之一。你可以找到此处提供有关这些附加API的文档.

使用WordPress REST API

WordPress已经为构建站点提供了一套丰富的工具和接口,如果您的站点已经按照预期的方式工作,那么您不应该感到使用REST API的压力。您不需要使用REST API来构建WordPress主题或插件。

然而,如果您确实希望将主题、插件或外部应用程序编写为客户端JavaScript应用程序,或用PHP以外的语言编写独立程序,那么您的应用程序将需要一种结构化的方式来访问WordPress网站内的内容。任何可以发出HTTP请求并解释JSON的编程语言都可以使用REST API与WordPress进行交互,从PHP、Node.js、Go和Java,到Swift、Kotlin等等。

即使您在主题或插件中使用普通JavaScript或jQuery,REST API也提供了一种比管理员-jax,使您能够花更少的时间访问所需的数据,花更多的时间创建更好的用户体验。

如果您想要一种结构化、可扩展且简单的方法来从WordPress中获取数据,那么您可能需要使用REST API。

尽管REST API很简单,但一开始可能会觉得相当复杂,因此在本手册中,我们将尝试将其分解为更小的组件,以解释整个谜题的每个部分。

接下来的步骤

熟悉关键技术概念REST API如何工作的背后。

了解有关如何与API资源交互以及在中查询特定数据的更多信息使用REST API第节。

一旦您熟悉了默认路由和方法的默认工作方式,就可以了解如何向API添加新数据,或者如何增强和操作扩展REST API第节。

要全面了解默认情况下可用的资源和路由,请查看API参考.