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认证为例:
- 向
/wp-json/jwt-auth/v1/token
发送POST请求,传递用户名和密码获取Token。 - 在后续请求的
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
:文章状态(如draft
、publish
、pending
)。categories
:分类ID数组(可选)。tags
:标签ID数组(可选)。
4. 处理响应
成功发布后,API会返回JSON格式的文章数据,包含ID、标题、链接等信息。若失败,需检查:
- 认证Token是否有效。
- 参数是否符合要求(如必填字段缺失)。
- 用户是否有发布权限。
5. 进阶功能
- 媒体文件上传:通过
/wp-json/wp/v2/media
接口上传图片并关联到文章。 - 自定义字段:通过
meta
参数传递自定义字段值。 - 定时发布:设置
date
参数为未来的时间戳。
结语
通过WordPress REST API发布文章,能够实现自动化内容管理,适用于多平台同步、移动应用集成等场景。合理利用API可以大幅提升工作效率,但需注意安全性,避免敏感信息泄露。