使用WordPress REST API发布文章的方法详解

来自:素雅营销研究院

头像 方知笔记
2025年05月05日 01:21

WordPress REST API为开发者提供了强大的接口,允许通过HTTP请求与WordPress站点进行交互。其中,发布文章是最常见的操作之一。本文将介绍如何通过WordPress REST API发布文章,并涵盖必要的权限验证和参数设置。

1. 准备工作

在使用WordPress REST API之前,需确保:

  • WordPress版本为4.7或更高(REST API已集成到核心)。
  • 已安装并启用REST API插件(如使用旧版本)。
  • 拥有足够的权限(如管理员或编辑角色)。

2. 获取认证凭据

由于发布文章涉及敏感操作,需进行身份验证。常用的认证方式包括:

  • JWT认证:通过插件(如JWT Authentication for WP REST API)生成Token。
  • OAuth1.0/OAuth2.0:适用于第三方应用授权。
  • 基本认证(仅限开发环境,不建议生产环境使用)。

以下以JWT认证为例:

  1. /wp-json/jwt-auth/v1/token发送POST请求,传递用户名和密码获取Token。
  2. 在后续请求的Authorization头中添加Bearer {Token}

3. 发布文章的API请求

WordPress的文章发布接口为:

POST /wp-json/wp/v2/posts

请求示例(使用cURL):

curl -X POST http://your-site.com/wp-json/wp/v2/posts \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "API测试文章",
"content": "这是通过REST API发布的内容。",
"status": "publish"
}'

关键参数说明:

  • title:文章标题(必填)。
  • content:文章正文(支持HTML)。
  • status:文章状态(如draftpublishpending)。
  • categories:分类ID数组(可选)。
  • tags:标签ID数组(可选)。

4. 处理响应

成功发布后,API会返回JSON格式的文章数据,包含ID、标题、链接等信息。若失败,需检查:

  • 认证Token是否有效。
  • 参数是否符合要求(如必填字段缺失)。
  • 用户是否有发布权限。

5. 进阶功能

  • 媒体文件上传:通过/wp-json/wp/v2/media接口上传图片并关联到文章。
  • 自定义字段:通过meta参数传递自定义字段值。
  • 定时发布:设置date参数为未来的时间戳。

结语

通过WordPress REST API发布文章,能够实现自动化内容管理,适用于多平台同步、移动应用集成等场景。合理利用API可以大幅提升工作效率,但需注意安全性,避免敏感信息泄露。