WordPress API:它们是什么以及如何使用它们
已发表: 2024-09-13WordPress JSON REST API 在 WordPress 社区中引起了不小的轰动,为开发人员和内容创建者等提供了新的可能性。
虽然听起来可能很复杂,但了解 JSON、REST 和 API 等关键术语可以简化您与 WordPress 广泛功能的交互方式。
什么是 API?
API 代表“应用程序编程接口”,本质上是一组允许不同软件应用程序相互通信的编程指令和标准。
想象一下一个软件应用程序向另一个软件应用程序发出指示——API 是管理这种交互的一组商定的规则。当一个软件向另一个软件发送指令时,API 会促进操作或提供必要的信息。
您可以将 API 视为两个软件系统之间的“用户界面”,处理数据通信和任务执行,但对最终用户不可见。
API 示例
当您开发 Web 应用程序时,能够访问 API 真是太棒了。当 API 向公众发布时,意味着开发人员创建了由该软件服务提供支持的解决方案。通常,它们消除了许多任务重新发明轮子的需要,因为它们已经被创建了。
亚马逊就是 API 的一个很好的例子。亚马逊发布了其API,以便开发人员可以轻松访问产品及其信息。访问此功能可以轻松地在亚马逊上发布产品链接,并提供更新的价格和购买选项。
API 交互的另一个例子是音乐会门票购买。要正式购买门票,您需要输入您的信用卡信息。 API 用于将您的信用卡信息发送到远程应用程序,然后该应用程序会验证信用卡信息是否正确。
一切检查完毕后,远程应用程序会将响应发送回门票网站,表示可以继续,此时您已成功购买门票。当这一切发生时,你只看到一个界面,那就是票务网站。这是一个无缝的过程;在幕后,许多应用程序使用 API 一起工作,但作为用户,您不会注意到任务何时从一个应用程序移交给另一个应用程序。
API 和 WordPress
亚马逊和票务购买是 API 如何协同工作的绝佳示例,但这如何应用于 WordPress?
嗯,所有相同的想法都适用。使用 WordPress API,您可以将数据推送到 WordPress 或从 WordPress 中提取数据。
API 是一个关键工具,开发人员可以使用它轻松地将 WordPress 网站的数据共享到其他网站或应用程序。具体来说,此 API 允许您对 WordPress 内容执行create
、 read
、 update
和delete
(CRUD) 操作。内容类型的一些示例是:
- 帖子
- 自定义帖子类型
- 页数
- 分类法
- 用户
- 媒体
休息是什么意思?
这里没有打瞌睡或打鼾——REST 指的是 API 的架构风格。 REST 代表表述性状态转移。
还记得我们如何提到 API 提供了通信细节,以便程序可以相互通信吗? REST API 的设计方式是提供一种轻量级的通信方法,从而节省带宽。 WordPress JSON REST API 就是这样做的,当数据量很大时,它是一个很好的选择。
我们刚刚触及 REST 的皮毛;如果您想了解更多信息,请查看此 REST 有用教程。
JSON格式
为了访问数据,我们需要一个来源。这就是 JSON 的用武之地。JSON 代表 JavaScript 对象表示法。
JSON 对于人类和机器来说都很容易阅读和理解。这是以有组织且易于访问的方式存储信息的完美方式。由于 JSON 非常易于访问,因此非常适合创建 REST API,并且是 WordPress JSON REST API 的完美解决方案。
以下是 JSON 格式的基本概念:
[javascript]
{“雇员”:[
{“名字”:“简”,“姓氏”:“史密斯”},
{“firstName”:“安娜”,“lastName”:“奥尔森”},
{“名字”:“乔什”,“姓氏”:“琼斯”}
]}
[/javascript]
WordPress 中的 JSON 格式
JSON 不只是自己编写,但不用担心,您不必手动创建 JSON 文件。有一些插件可以为您创建它。使用这些工具之一,网站的数据将采用正确的格式,包括用户、帖子、页面、分类法等。
使用 JSON REST API
使用 API 是非常不言自明的;您将以简单的 JSON 格式获取网站的数据。如果您安装了插件,则可以尝试以数据形式查看网站的帖子。
检索或更新数据就像发送 HTTP 请求一样简单。 HTTP 是一种请求/响应协议。首先,您发送数据请求,然后数据作为响应发回。
获取方法
GET方法用于检索信息,对数据没有影响。只需将 GET 请求发送到/wp-json/wp/v2/posts
即可。想要寻找一些东西吗?例如,如果您搜索“development”,您将通过 GET 请求/wp-json/wp/v2/posts?search=development
获得结果。
发布请求
POST 请求用于发送数据。例如,利用新 API 的功能,您可以更新用户。假设您要更新 ID 为 10 的用户。您所要做的就是向/wp-json/wp/v2/users/10
发送 POST 请求。
要尝试此操作,我们建议使用 Postman,一个 Google Chrome 扩展程序。
混合更多 Javascript
Backbone.js 和 API
Backbone.js 是使用 API 的好方法,因为它是一个专为使用 REST API 而设计的框架。 WordPress API 包括一个基于 Backbone 模型的易于使用的 Javascript API。这使得插件和主题开发人员无需超级深入的努力和了解连接的细节即可启动并运行。
还有更多内容,但 Backbone 通过提供模型、集合和视图为 Web 应用程序提供结构,并通过 REST JSON 接口将其全部连接到 WordPress API。
这对 WordPress 开发者意味着什么?
随着 WordPress API 的推出,使用它的新方法已经增加,并且随着它的流行,这种情况还将继续增加。 WordPress API 可以改进几乎所有依赖 Javascript 的现有 WordPress 功能。以下是一些示例:
- 表单验证/提交
- Backbone.js 主题或插件
- 无限滚动
这也是显示其他来源的内容的好方法。现在,可以轻松地在多站点设置中显示来自单个站点的内容。还可以显示来自完全独立的 WordPress 站点的内容。除了展示内容之外,内容的更新也可以更加轻松有效。
现在我们已经了解了一些基本术语,我们知道 JSON 是表示法,REST 是架构风格,API 是它们组成的接口。了解 API 的基础知识及其功能将确保您在探索 WordPress API 的新可能性时有一个良好的开端。