什么是WordPress接口
WordPress接口是指允许外部应用程序与WordPress网站进行数据交互的编程接口。通过接口，开发者可以实现创建、读取、更新和删除(CRUD)WordPress内容的功能，而无需直接访问数据库。
常用的WordPress接口类型
- REST API：WordPress 4.7版本后内置的核心功能，提供标准的RESTful接口
- XML-RPC：较旧的接口协议，仍被一些应用使用
- 自定义API：开发者根据需求自行创建的专用接口
使用WordPress REST API
基础配置
WordPress REST API默认已启用，无需额外安装插件。要开始使用：
- 确保WordPress版本在4.7或以上
- 在”设置”→”固定链接”中选择非默认的URL结构(推荐”文章名”)
常用REST API端点示例
- 获取文章：
/wp-json/wp/v2/posts - 获取页面：
/wp-json/wp/v2/pages - 获取分类：
/wp-json/wp/v2/categories - 获取标签：
/wp-json/wp/v2/tags
发送请求示例
// 获取最新5篇文章
fetch('https://your-site.com/wp-json/wp/v2/posts?per_page=5')
.then(response => response.json())
.then(posts => console.log(posts));
创建自定义REST API端点
当内置API无法满足需求时，可以创建自定义端点：
// 在主题的functions.php或自定义插件中添加
add_action('rest_api_init', function () {
register_rest_route('custom/v1', '/hello', array(
'methods' => 'GET',
'callback' => 'custom_api_hello',
));
});
function custom_api_hello() {
return array('message' => 'Hello from WordPress API!');
}
访问地址：/wp-json/custom/v1/hello
接口安全与认证
WordPress提供多种认证方式保护API：
- 基本认证：用户名密码直接传输(仅建议在HTTPS下使用)
- Cookie认证：已登录用户的自动认证
- OAuth认证：通过插件如”Application Passwords”实现
- JWT认证：需要安装JWT插件
使用Application Passwords
- 安装”Application Passwords”插件
- 在用户编辑页面生成新密码
- 在请求头中添加认证：
Authorization: Basic base64_encode(username:password)
性能优化建议
- 限制返回字段：使用
_fields参数指定所需字段 - 启用缓存：对不常变的数据使用缓存
- 分页处理：合理使用
per_page和page参数 - 禁用不必要的端点：通过
rest_endpoints过滤器
常见问题解决
- 返回404错误：检查固定链接设置，确保不是默认设置
- 权限不足：确认用户角色和权限，必要时添加权限检查
- 跨域问题：添加CORS头或通过代理访问
- 性能瓶颈：优化查询，考虑使用缓存插件
进阶开发建议
- 使用WP-CLI测试API端点
- 结合ACF(高级自定义字段)创建更复杂的数据结构
- 参考WordPress官方REST API手册了解最新功能
- 考虑使用Postman等工具进行API测试
通过掌握这些WordPress接口开发技巧，您可以轻松实现WordPress与其他系统的数据交互，为网站添加更多可能性。
