如何使用WordPress REST API发布文章

WordPress REST API为开发者提供了一种强大的方式来与WordPress站点进行交互，无需直接访问数据库或使用传统的PHP函数。本文将详细介绍如何使用WordPress REST API来发布文章。

准备工作

在使用WordPress REST API发布文章前，需要确保：

1. WordPress版本在4.7或以上
2. 已安装并激活REST API插件（如果使用旧版本）
3. 获取了有效的认证凭据（如JWT令牌或应用密码）

基本请求结构

发布文章的API端点是：

POST /wp-json/wp/v2/posts

请求需要包含以下基本参数：

• title：文章标题
• content：文章内容
• status：文章状态（publish、draft等）

认证方式

WordPress REST API支持多种认证方式：

1. 基本认证：不推荐用于生产环境
2. OAuth：更安全的方式
3. JWT认证：需要安装JWT插件
4. 应用密码：WordPress 5.6+原生支持

示例代码

以下是使用JavaScript（Fetch API）发布文章的示例：

fetch('https://your-site.com/wp-json/wp/v2/posts', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN_HERE'
},
body: JSON.stringify({
title: '我的第一篇文章',
content: '这是通过REST API发布的内容',
status: 'publish'
})
})
.then(response => response.json())
.then(post => console.log('发布成功:', post))
.catch(error => console.error('错误:', error));

高级参数

除了基本参数，还可以设置：

• excerpt：文章摘要
• featured_media：特色图片ID
• categories：分类ID数组
• tags：标签ID数组
• date：发布时间（ISO8601格式）

错误处理

常见错误包括：

• 401未授权：认证失败
• 403禁止访问：用户权限不足
• 400错误请求：参数缺失或格式错误

最佳实践

1. 始终在生产环境使用HTTPS
2. 限制API密钥的权限范围
3. 实现适当的错误处理和日志记录
4. 考虑使用缓存减少API调用

通过掌握WordPress REST API发布文章的方法，开发者可以构建更灵活的内容管理系统，实现自动化发布流程，或与其他系统集成。