WordPress REST API为WordPress带来了许多新功能。REST API使用JSON(JavaScript对象符号)作为其数据格式。JSON是一种开放的标准数据格式,在整个网络中越来越广泛使用,并且通常是软件。它是轻巧和人类可读性的,看起来像对象在JavaScript中所做的;由此得名。当您向API提出请求时,响应将在JSON中返回。这使开发人员可以在PHP以外的语言中使用WordPress,这又允许WordPress以新颖而令人兴奋的方式使用。
为什么使用WordPress REST API
WordPress REST API有很多用例。最大的用例之一是在WordPress之上创建单页应用程序。您可以为WordPress创建全新的管理经验,也可以为WordPress创建全新的前端体验。您甚至不必在PHP中编写应用程序。任何可以提出HTTP请求和解释JSON的编程语言都可以用来在WordPress上写入一些内容。
WordPress REST API还可以作为核心Admin-Ajax API的强大替换。通过使用REST API,您可以更轻松地构建想要将数据输入WordPress的方式。通过使用REST API可以极大地简化AJAX调用,从而使我们能够在工作中提供更好的用户体验。
用例超出了这些范围,实际上我们的想象力是可以做什么的唯一限制。最重要的是,如果您想要一种结构化,可扩展和简单的方法来将数据输入WordPress,则可能需要使用REST API。对于所有简单性,API起初可能非常复杂,我们将尝试将其分解为较小的组件,以便我们可以轻松地将较大的拼图拼凑在一起。
关键概念
为了开始使用WordPress REST API,我们将分解与API相关的一些关键概念和术语:
- 路线/端点
- 要求
- 回答
- 模式
- 控制器类
这些概念中的每一个都在使用和理解WordPress REST API中起着至关重要的作用。让我们简要地分解它们,以便我们以后可以更深入地探索每个人。
路线和端点
在WordPress REST API的上下文中,路由是可以映射到不同HTTP方法的URI。单个HTTP方法对路线的映射称为端点。澄清:如果我们做一个GET
请求http://oursite.com/wp-json/
,我们将获得JSON响应,向我们展示可用的路线,在每个路线中,可用的端点可用。/wp-json/
是一条路线本身,当GET
请求与端点匹配,该端点显示WordPress REST API所谓的索引。我们将在以下各节中学习如何注册自己的路线和端点。
要求
在WordPress Rest API基础架构中,主要类是WP_REST_Request
。该请求类用于存储和检索当前请求的信息,也可以在PHP内部内部提出请求,以避免使用HTTP。WP_REST_Request
每当您向注册路线提出HTTP请求时,对象将自动为您生成。请求中指定的数据将影响您从API中获得的响应。使用请求类可以完成很多整洁的事情。请求部分将详细介绍。
回答
响应是您从API中返回的数据。这WP_REST_Response
提供了一种与端点返回的响应数据进行交互的方法。响应可以返回所需的数据,也可以用于返回错误。
模式
当我们有不同类型数据的响应和请求时,我们需要能够分辨出与哪种类型的数据进行交互。模式为我们提供了构建数据的方法。模式还为API提供了安全福利,因为它使我们能够验证向API提出的请求。模式是一个大主题,我们将在“模式”部分中介绍。
控制器类
如您所见,WordPress REST API具有许多需要一起工作的活动部件。控制器类使我们能够将所有这些元素放在一个地方。使用控制器类,我们将能够管理路由和端点的注册,处理请求,使用架构并生成响应。
下一步
让我们研究如何注册REST API的路由和端点。