第 10 章 WordPress REST API WordPress REST API
本作品已使用人工智能进行翻译。欢迎您提供反馈和意见:translation-feedback@oreilly.com
在WordPress 4.4版本中,该项目引入了REST API,使WordPress比以往任何时候都更具可扩展性。通过 WordPress REST API,开发人员可以从 WordPress 外部向 WordPress 推送和提取数据。这样,您就可以创建各种很酷、很有用的软件应用程序,它们不一定使用传统的WordPress用户界面,但都由WordPress提供支持或与WordPress集成。它允许您与其他软件应用程序进行通信,而无需考虑应用程序的编程语言。在了解使用WordPress REST API的具体细节之前,让我们先快速描述一下 "REST API "的一般含义。
备注
本章所涵盖的内容与 WordPress 的REST API 详细使用手册基本相同。在某些部分,我们会介绍更多细节,或使用在本书中更有意义的示例。请注意,我们在此简要介绍的某些内容在 WordPress 手册中也有更详细的介绍。
什么是 REST API?
您可能已经知道什么是 REST API ,甚至对 WordPress 没有尽早内置 REST API 感到惊讶。让我们试着用巴尼(Barney)的风格来解释一下--你知道的,就是那个烦人的紫色大恐龙,孩子们曾经为它着迷,家长们恨不得挖掉他们的眼睛和耳朵。
备注
有些人将WordPress REST API称为JSON REST API。在本章中,我们将不使用 "WordPress",而只写 REST API。
让我们来了解一些基本知识。
应用程序接口
应用程序接口(API)是软件应用程序内置的功能和工具集合,开发人员可利用它与软件应用程序进行内部或外部交互,通常是通过网络应用程序之间的互联网进行交互。根据 API 的设置方式,您可以使用它将内容和数据推入或拉出另一个应用程序,从而有效地集成两个或多个应用程序。
REST API 允许您从 WordPress 网站外部与 WordPress 数据库交互。
REST
REST(表示状态转移)是 用来定义网络应用程序之间基于 HTTP 的通信的一种架构风格。构建 REST 应用程序接口有一些指导原则,接口必须满足以下各项约束条件才能成为RESTful。
-
客户端-服务器
-
无国籍
-
可缓存
-
统一界面
-
分层系统
-
按需编码
JSON
如前所述,JSON 是一种开放的标准文本格式,用于发送数组和名-值对等数据对象中的可读文本。REST API HTTP 请求的响应应为 JSON 格式。您应该能够解析 HTTP 响应中的 JSON 格式,并在应用程序中使用该数据。
超文本传输协定
HTTP是客户端和服务器之间请求和响应的标准。每次通过网络浏览器访问网站时,您都会发出 HTTP 请求,并收到 HTTP 响应或浏览器加载的网页。通过REST API向WordPress推送数据和从WordPress拉取数据也是通过相同的协议进行的,但返回的不是网页,而是JSON格式的原始数据。在默认安装了WordPress的情况下,如果您直接在浏览器中输入适当的URL或API路由,就可以通过HTTP请求访问JSON格式的公共内容,如帖子和页面。
使用像WordPress这样的RESTful API时,有四种主要的HTTP请求方法。
-
POST -
GET