什么是WordPress REST API?
WordPress REST API 是一种基于 HTTP 协议的接口,允许开发者通过标准的 RESTful 请求与 WordPress 站点进行数据交互。它支持对文章、页面、用户、评论等核心数据的增删改查(CRUD)操作,同时也能扩展自定义内容类型。
为什么使用WordPress REST API?
- 前后端分离:开发者可以构建独立的前端应用(如React、Vue等),通过API与WordPress后端交互。
- 跨平台整合:移动应用或其他系统可通过API直接调用WordPress数据。
- 自动化流程:批量管理内容、同步数据或与其他工具(如CRM、电商平台)集成。
基础使用方法
1. 获取公开数据(无需认证)
通过简单的 GET
请求即可获取文章列表:
curl https://your-wordpress-site.com/wp-json/wp/v2/posts
2. 提交数据(需认证)
如需创建或修改内容,需使用OAuth或JWT进行身份验证。例如,发布新文章:
curl -X POST https://your-wordpress-site.com/wp-json/wp/v2/posts \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title":"Hello API", "content":"REST API test", "status":"publish"}'
高级应用场景
自定义端点
通过 register_rest_route()
扩展自定义API功能:
add_action('rest_api_init', function() {
register_rest_route('myplugin/v1', '/data', [
'methods' => 'GET',
'callback' => 'my_custom_data_handler',
]);
});
function my_custom_data_handler() {
return ['key' => 'value'];
}
与第三方服务集成
结合Webhook或Zapier,实现自动触发动作(如新文章发布时推送通知)。
安全注意事项
- 权限控制:使用
permission_callback
验证请求权限。 - 数据过滤:对输入输出数据使用
sanitize
和validate
函数。 - 限流机制:防止API滥用。
结语
WordPress REST API 为开发者提供了强大的灵活性,无论是构建单页应用(SPA)还是实现系统集成,都能显著提升效率。通过合理设计端点和安全策略,可以充分发挥其潜力。
提示:WordPress默认启用REST API,若需禁用部分功能,可通过插件或代码过滤。