February 6, 2026 Uncategorized

WordPress REST API入门指南:轻松获取网站数据的实用方法

什么是WordPress REST API?

WordPress REST API是一个强大的工具,它允许您通过简单的网址请求来获取网站的各种数据。无论您是想在自己的应用中显示文章列表,还是需要整合其他系统,这个API都能让数据获取变得非常简单。本文将重点介绍最常用的数据获取方法,特别适合初学者使用。

重要提示:参数使用技巧

在使用API时,有些参数写法需要注意。经过测试,像filter[posts_per_page]这样的写法可能不起作用,建议改用per_page参数。例如:
http://www.website.com/wp-json/wp/v2/posts?per_page=5&page=2

文章数据获取方法

1. 获取最新文章

默认情况下,API会返回最新的10篇文章:
http://www.website.com/wp-json/wp/v2/posts
您也可以指定页码:
http://www.website.com/wp-json/wp/v2/posts?page=1
要获取第11-20篇文章,使用:
http://www.website.com/wp-json/wp/v2/posts?page=2

2. 控制每页显示数量

如果您希望每页只显示5篇文章:
http://www.website.com/wp-json/wp/v2/posts?per_page=5
结合分页使用:
http://www.website.com/wp-json/wp/v2/posts?per_page=5&page=2

3. 按分类筛选文章

要获取特定分类的文章,需要知道分类ID。在WordPress后台的“分类目录”页面,将鼠标悬停在分类名称上,可以看到类似tag_ID=2的参数,这个数字就是分类ID。
获取分类ID为2的文章:
http://www.website.com/wp-json/wp/v2/posts?categories=2

4. 按标签筛选文章

获取带有特定标签的文章:
http://www.website.com/wp-json/wp/v2/posts?tags=library

5. 组合筛选条件

您可以同时按分类和标签筛选:
http://www.website.com/wp-json/wp/v2/posts?categories=2&tags=library

6. 按日期筛选

获取2016年3月的文章:
http://www.website.com/wp-json/wp/v2/posts?filter[year]=2016&filter[monthnum]=03

7. 按作者筛选

获取特定作者的文章:
http://www.website.com/wp-json/wp/v2/posts?filter[author_name]=jinyun

8. 关键词搜索

搜索包含特定关键词的文章:
http://www.website.com/wp-json/wp/v2/posts?filter[s]=关键词

9. 获取随机文章

随机排序文章:
http://www.website.com/wp-json/wp/v2/posts?filter[orderby]=rand

10. 获取相关文章

在woocommercedev网站上,我们经常需要显示相关文章来提升用户体验和SEO效果。以下是两种常用方法:
按标签获取6篇随机相关文章:
http://www.website.com/wp-json/wp/v2/posts?filter[orderby]=rand&tags=library&per_page=6
按分类获取6篇随机相关文章:
http://www.website.com/wp-json/wp/v2/posts?filter[orderby]=rand&categories=2&per_page=6

11. 获取单篇文章

获取ID为189的特定文章:
http://www.website.com/wp-json/wp/v2/posts/189

其他数据类型获取方法

分类和标签数据

获取所有分类:
http://www.website.com/wp-json/wp/v2/categories
获取特定分类信息(ID为2):
http://www.website.com/wp-json/wp/v2/categories/2
获取所有标签:
http://www.website.com/wp-json/wp/v2/tags
获取特定标签信息(ID为3):
http://www.website.com/wp-json/wp/v2/tags/3

媒体文件

获取所有媒体信息:
http://www.website.com/wp-json/wp/v2/media
获取特定媒体信息(ID为17):
http://www.website.com/wp-json/wp/v2/media/17

页面数据

获取所有页面信息:
http://www.website.com/wp-json/wp/v2/pages
获取特定页面信息(ID为289):
http://www.website.com/wp-json/wp/v2/pages/289

内容类型

获取所有内容类型(通常包括文章、页面和附件):
http://www.website.com/wp-json/wp/v2/types
获取特定类型信息:
http://www.website.com/wp-json/wp/v2/types/post

评论数据

获取所有评论信息:
http://www.website.com/wp-json/wp/v2/comments
获取特定评论信息(ID为2):
http://www.website.com/wp-json/wp/v2/comments/2

用户数据

获取所有用户信息:
http://www.website.com/wp-json/wp/v2/users
获取特定用户信息(ID为1):
http://www.website.com/wp-json/wp/v2/users/1

总结与建议

通过woocommercedev的这份指南,您已经掌握了WordPress REST API最基本的数据获取方法。这些接口可以帮助您轻松地从WordPress网站获取各种数据,无论是用于自定义开发、数据整合还是创建独特的前端体验。

元描述建议:学习如何使用WordPress REST API轻松获取网站数据。本文详细介绍了文章、分类、标签、媒体等各类数据的获取方法,适合初学者和开发者参考。

请注意,本文主要介绍数据获取(GET请求),提交数据涉及更复杂的认证机制,我们将在后续文章中专门介绍。如果您在使用woocommercedev的过程中遇到任何问题,欢迎查阅我们的其他教程或联系技术支持。

Leave a Reply

Your email address will not be published. Required fields are marked *