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),表示帖子、页面、分类和其他内置WordPres数据类型。您的应用程序可以向这些端点发送和接收JSON数据,以便在您的站点上查询、修改和创建内容。JSON是一种开放的标准数据格式,它是轻量级的、可读的,看起来就像Object在JavaScript中所做的那样。当您从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参考.