本文目录导读：

1. 引言
2. 1. WordPress REST API 简介
3. 2. 连接外部系统的准备工作
4. 3. 使用 WordPress REST API 连接外部系统
5. 4. 高级应用：自定义 REST API 端点
6. 5. 安全性与最佳实践
7. 6. 结论

WordPress 是全球最流行的内容管理系统（CMS），它不仅适用于博客和网站，还可以作为强大的后端系统与其他应用程序集成，WordPress REST API 提供了一种标准化的方式，让开发者可以通过 HTTP 请求与 WordPress 进行交互，从而实现与外部系统的无缝连接，无论是构建移动应用、第三方服务集成，还是自动化内容管理，WordPress REST API 都能提供灵活且高效的解决方案。

本文将详细介绍如何使用 WordPress REST API 连接外部系统，包括 API 的基本概念、认证方式、常见用例以及具体的代码示例。

---

WordPress REST API 简介

WordPress REST API 是一个基于 JSON 的接口，允许开发者通过 HTTP 请求（GET、POST、PUT、DELETE 等）与 WordPress 进行交互，它遵循 REST（Representational State Transfer）架构风格，提供了一种标准化的方式来访问和操作 WordPress 的数据，如文章、页面、用户、评论等。

1 WordPress REST API 的核心概念

• 端点（Endpoints）：API 提供的 URL 路径，用于访问特定资源（如 /wp-json/wp/v2/posts 获取文章）。
• HTTP 方法：
  • GET：获取数据
  • POST：创建数据
  • PUT/PATCH：更新数据
  • DELETE：删除数据
• JSON 数据格式：所有请求和响应均采用 JSON 格式，便于跨平台解析。

2 默认 REST API 端点

WordPress 默认提供以下 REST API 端点：

• /wp-json/wp/v2/posts：管理文章
• /wp-json/wp/v2/pages：管理页面
• /wp-json/wp/v2/users：管理用户
• /wp-json/wp/v2/comments：管理评论
• /wp-json/wp/v2/media：管理媒体文件

开发者还可以自定义 REST API 端点，以满足特定需求。

---

连接外部系统的准备工作

在开始使用 WordPress REST API 连接外部系统之前，需要确保以下几点：

1 确保 WordPress 支持 REST API

WordPress 4.7+ 版本默认启用了 REST API，但某些插件或主题可能会禁用或修改 API 行为，可以通过访问 http://your-site.com/wp-json/ 来检查 API 是否可用。

2 配置 HTTPS

由于 REST API 涉及数据传输，建议使用 HTTPS 以确保安全性，可以通过 SSL 证书（如 Let's Encrypt）启用 HTTPS。

3 选择合适的认证方式

WordPress REST API 默认允许匿名访问公共数据（如文章列表），但如果要修改数据（如发布文章、更新用户信息），则需要认证，常见的认证方式包括：

1. 基本认证（Basic Auth）（适用于开发环境）

   • 使用 username:password 进行 Base64 编码。
   • 需要安装插件（如 Basic Auth 或 Application Passwords）。

2. OAuth 1.0a（适用于生产环境）

   • 更安全,但配置较复杂。
   • 需要安装 OAuth 1.0a Server 插件。

3. JWT（JSON Web Token）（推荐）

   • 适用于现代 Web 应用和移动端。
   • 需要安装 JWT Authentication for WP REST API 插件。

4. Application Passwords（WordPress 5.6+）

   • 内置功能,无需额外插件。
   • 适用于自动化脚本和第三方应用。

---

使用 WordPress REST API 连接外部系统

我们将通过几个实际用例演示如何连接外部系统。

1 获取 WordPress 文章（GET 请求）

假设我们需要从外部系统获取 WordPress 的最新文章列表，可以使用 GET 请求：

// 使用 JavaScript（Fetch API）
fetch('https://your-site.com/wp-json/wp/v2/posts')
  .then(response => response.json())
  .then(posts => console.log(posts));

Python 示例：

import requests
response = requests.get("https://your-site.com/wp-json/wp/v2/posts")
posts = response.json()
print(posts)

2 创建新文章（POST 请求）

如果要在外部系统（如自动化工具）中发布文章到 WordPress，可以使用 POST 请求：

// 使用 JavaScript（需认证）
fetch('https://your-site.com/wp-json/wp/v2/posts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_JWT_TOKEN' // 或 Basic Auth
  },
  body: JSON.stringify({ 'Hello World',
    content: 'This is a new post via REST API',
    status: 'publish'
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python 示例（使用 Basic Auth）：

import requests
from requests.auth import HTTPBasicAuth
url = "https://your-site.com/wp-json/wp/v2/posts"
data = {: "Hello World",
    "content": "This is a new post via REST API",
    "status": "publish"
}
response = requests.post(
    url,
    json=data,
    auth=HTTPBasicAuth("username", "password")
)
print(response.json())

3 更新文章（PUT/PATCH 请求）

如果需要修改现有文章,可以使用 PUT 或 PATCH 请求：

fetch('https://your-site.com/wp-json/wp/v2/posts/123', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_JWT_TOKEN'
  },
  body: JSON.stringify({ 'Updated Title',
    content: 'Updated content via REST API'
  })
})
.then(response => response.json())
.then(data => console.log(data));

4 删除文章（DELETE 请求）

要删除某篇文章,可以使用 DELETE 请求：

fetch('https://your-site.com/wp-json/wp/v2/posts/123', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN'
  }
})
.then(response => response.json())
.then(data => console.log(data));

---

高级应用：自定义 REST API 端点

如果默认的 API 端点无法满足需求，可以创建自定义 REST API 端点，我们创建一个返回自定义数据的端点：

1 在 WordPress 中注册自定义端点

在主题的 functions.php 文件中添加：

add_action('rest_api_init', function () {
  register_rest_route('custom/v1', '/data', array(
    'methods' => 'GET',
    'callback' => 'get_custom_data',
  ));
});
function get_custom_data() {
  return array(
    'message' => 'Hello from custom API!',
    'timestamp' => time(),
  );
}

2 访问自定义端点

外部系统可以通过以下方式访问：

fetch('https://your-site.com/wp-json/custom/v1/data')
  .then(response => response.json())
  .then(data => console.log(data));

---

安全性与最佳实践

• 使用 HTTPS：防止数据泄露。
• 限制 API 访问：通过 .htaccess 或插件限制 IP 访问。
• 定期更新 WordPress 和插件：防止安全漏洞。
• 使用速率限制（Rate Limiting）：防止滥用 API。

---

WordPress REST API 提供了一种强大的方式，使外部系统能够与 WordPress 无缝集成，无论是获取数据、发布内容，还是构建自定义 API，都可以通过标准的 HTTP 请求实现，通过本文的指南，你可以轻松开始使用 WordPress REST API 连接外部系统，并实现自动化内容管理、移动应用开发等高级功能。

如果你正在构建一个需要与 WordPress 交互的系统，不妨尝试 REST API，它将为你带来极大的灵活性和效率提升！