ThinkChat2.0新版上线,更智能更精彩,支持会话、画图、视频、阅读、搜索等,送10W Token,即刻开启你的AI之旅 广告
WordPress REST API为WordPress数据类型提供了API端点,允许开发人员通过发送和接收JSON(JavaScript对象符号)对象来远程与站点进行交互 。JSON是一种开放标准的数据格式,它是轻量级和人类可读的,看起来像JavaScript在JavaScript中; 由此得名。当您向API发送内容或向API发出请求时,响应将以JSON格式返回。这使开发人员能够从客户端JavaScript或外部应用程序(甚至是使用PHP之外的语言编写)创建,读取和更新WordPress内容。 注意:查找WordPress中提供的其他API的列表?您可以在这里找到文档。 为什么使用WordPress REST API #为什么使用WordPress REST API WordPress REST API比以往更容易以新的和令人兴奋的方式使用WordPress,例如在WordPress之上创建单页应用程序。您可以创建一个插件,为WordPress提供全新的管理体验,或创建一个全新的交互式前端体验。 您甚至不必在PHP中编写应用程序:任何可以使HTTP请求和解释JSON的编程语言都可以通过REST API与WordPress进行交互,从Node.js到Java及更高版本。 WordPress REST API也可以作为core-ajax API的强大替代品。通过使用REST API,您可以更容易地构造您想要将数据导入和导出WordPress的方式。通过使用REST API可以大大简化AJAX调用,使您可以花更少的时间访问所需的数据,并有更多时间创建更好的用户体验。 我们的想象力是WordPress REST API可以做到的唯一限制。底线是,如果你想要一个结构化,可扩展和简单的方式通过HTTP获取数据进出WordPress,你可能想使用REST API。为了所有的简单性,REST 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。此类用于存储和检索当前请求的信息; 请求可以通过HTTP远程提交,但也可以从PHP与WordPress内部。WP_REST_Request当您向注册的路由发出HTTP请求时,将自动为您生成对象。请求中指定的数据将决定您从API获取的响应。有很多整洁的事情,你可以使用请求类。请求部分将更详细地介绍。 顶部↑ 响应#响应 响应是您从API获取的数据。在WP_REST_Response提供了一种具有由端点返回的响应数据进行交互。响应可以返回所需的数据,也可以用于返回错误。 顶部↑ 模式#模式 每个端点需要并提供略微不同的数据结构,这些结构在API模式中定义。模式结构API数据,并提供API可以返回的所有属性以及可以接受的输入参数的全面列表。Schema还为API提供了安全优势,因为它使我们能够验证对API的请求。模式部分进一步探讨这个大主题。 顶部↑ 控制器类#控制器类 如你所见,WordPress REST API有很多移动部件,所有这些都需要一起工作。控制器类将所有这些元素集中在一个地方。使用控制器类,您可以管理路由和端点的注册,处理请求,利用模式和生成API响应。 顶部↑ 后续步骤#下一步 让我们看看WordPress REST API的参考。