什么是WordPress REST API?
WordPress REST API 是 WordPress 提供的一套基于 HTTP 协议的接口,允许开发者通过标准的 RESTful 方式与 WordPress 站点进行交互。无论是获取文章、创建页面,还是管理用户数据,都可以通过发送 HTTP 请求(如 GET、POST、PUT、DELETE)来实现。
核心功能与用途
- 数据获取与操作
- 通过
/wp-json/wp/v2/posts
获取文章列表 - 使用
/wp-json/wp/v2/users
管理用户信息 - 支持自定义文章类型(CPT)和分类法
- 跨平台整合
- 可用于构建移动应用(React Native、Flutter)
- 与前端框架(如 Vue.js、React)无缝对接
- 自动化与扩展
- 结合 Webhook 实现自动化流程(如发布触发通知)
- 与第三方服务(CRM、电商系统)集成
基础使用示例
获取文章列表(GET请求)
curl https://your-site.com/wp-json/wp/v2/posts
返回 JSON 格式数据,包含标题、内容、作者等信息。
创建新文章(POST请求)
需认证后操作,示例代码(使用 JavaScript Fetch API):
fetch('/wp-json/wp/v2/posts', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN'
},
body: JSON.stringify({
title: '新文章标题',
content: '文章内容',
status: 'publish'
})
});
认证与权限控制
WordPress REST API 支持多种认证方式:
- Cookie 认证:适用于已登录的 WordPress 用户
- OAuth 1.0a:需安装插件(如 Application Passwords)
- JWT:通过插件实现更灵活的令牌机制
自定义端点开发
通过 register_rest_route()
函数扩展 API:
add_action('rest_api_init', function () {
register_rest_route('custom/v1', '/hello', [
'methods' => 'GET',
'callback' => function () {
return ['message' => 'Hello, REST API!'];
}
]);
});
访问 /wp-json/custom/v1/hello
即可获取自定义响应。
官方文档与资源
掌握 WordPress REST API 能显著提升开发效率,尤其适合构建无头 CMS(Headless WordPress)或跨平台应用。建议从基础请求开始,逐步探索高级功能如过滤、分页和 Webhook 集成。