api 接口有什么用,其实在我们写小程序或者开发 APP 时,都需要调取接口获取数据的,wordpress 与时俱进已经为我们集成了,常用的 api 接口
一、文章
(1)获取最新文章(默认获取到最新的 10 篇文章)
http://www.website.com/wp-json/wp/v2/posts
与
http://www.website.com/wp-json/wp/v2/posts?page=1
效果相同,page 用于指定页数,WP REST API 默认返回 10 条数据,用 page 指定数据获取的游标。如
http://www.website.com/wp-json/wp/v2/posts?page=2
可取回最新的第 11 条数据到第 20 条数据,以此类推。
(2)设置获取的每页文章数量及分页
http://www.website.com/wp-json/wp/v2/posts?filter[posts_per_page]=5
filter[posts_per_page]=5 用于指定返回文章每页的数量,这里指定每页数量为 5 篇。
filter[posts_per_page] 与 page 联合使用:
http://www.website.com/wp-json/wp/v2/posts?filter[posts_per_page]=5&page=2
(3)获取指定分类的文章
http://www.website.com/wp-json/wp/v2/posts?filter[cat]=2
filter[cat]=2 指定分类 ID 为 2,返回分类 ID 为 2 的文章。
分类 ID 是每个分类目录在创建时自动生成的 ID,在 wordpress 后台“文章”==》“分类目录”中,把鼠标放在分类名称上面,页面下方会出现一个网址,网址中的参数 tag_ID= 2 就是这个分类名称的分类 ID。如果没有出现网址,可以点击分类名称下的“编辑”,然后查看网页地址栏,同样可以得到 tag_ID=2。下面的标签 ID 的获得方法也一样。
(4)获取指定标签的文章
http://www.website.com/wp-json/wp/v2/posts?filter[tag]=library
filter[tag]=library 指定标签名为“library”的文章
(5)获取指定分类和有指定标签的文章
http://www.website.com/wp-json/wp/v2/posts?filter[cat]=2&filter[tag]=library
上面两个结合一起,可以得到更具体精确的文章。
(6)获取指定日期的文章
http://www.website.com/wp-json/wp/v2/posts?filter[year]=2016&filter[monthnum]=03
filter[year]=2016&filter[monthnum]=03 设置指定的日期
(7)获取指定作者的文章
http://www.website.com/wp-json/wp/v2/posts?filter[author_name]=jinyun
filter[author_name]=jinyun 设置指定作者名字
(8)按关键词搜索文章
http://www.website.com/wp-json/wp/v2/posts?filter[s]= 金云
filter[s]= 金云:按给定的关键词搜索文章,返回包含“金云”关键词的文章。
(9)获取随机文章
http://www.website.com/wp-json/wp/v2/posts?filter[orderby]=rand
其中 orderby 还可以为指定的字段排序
(10)获取相关文章
在网站中,在做 SEO 优化和页面内容布局时,获取相关文章是比较常见的,可以通过以上几个条件组合来达到获取相关文章的效果。
按标签获取相关文章:
http://www.website.com/wp-json/wp/v2/posts?filter[orderby]=rand&filter[tag]=library&filter[posts_per_page]=6
按分类获取相关文章:
http://www.website.com/wp-json/wp/v2/posts?filter[orderby]=rand&filter[cat]=2&filter[posts_per_page]=6
(11)获取指定文章的数据
http://www.website.com/wp-json/wp/v2/posts/189
得到 ID 为 189 的文章数据
二、分类和标签
(1)获取所有的分类
http://www.website.com/wp-json/wp/v2/categories
(2)获取指定分类 ID 的分类信息
http://www.website.com/wp-json/wp/v2/categories/2
(3)获取所有的标签
http://www.website.com/wp-json/wp/v2/tags
(4)获取指定标签 ID 的标签信息
http://www.website.com/wp-json/wp/v2/tags/3
三、媒体文件
(1)获取所有的媒体信息
http://www.website.com/wp-json/wp/v2/media
(2)获取指定媒体 ID 的媒体信息
http://www.website.com/wp-json/wp/v2/media/17
四、页面
(1)获取所有的页面信息
http://www.website.com/wp-json/wp/v2/pages
(2)获取指定页面 ID 的页面信息
http://www.website.com/wp-json/wp/v2/pages/289
五、类型
(1)获取当前 wordpress 所有的内容类型
http://www.website.com/wp-json/wp/v2/types
一般情况下会返回 post,page 和 attachment 三种类型
(2)获取指定类型
http://www.website.com/wp-json/wp/v2/types/post
六、评论
(1)获取所有评论信息
http://www.website.com/wp-json/wp/v2/comments
(2)获取指定评论 ID 的单条评论信息
http://www.website.com/wp-json/wp/v2/comments/2
七、用户
(1)获取所有的用户信息
http://www.website.com/wp-json/wp/v2/users
(2)获取指定用户 ID 的用户信息
http://www.website.com/wp-json/wp/v2/users/1
以上即是 WordPress REST API 内置 API 接口最为常用的接口数据获取方法。
自定义接口可以看下一篇:wordpress 自定义 rest API 接口的开发