Wordpress 模板zibll子比 App API接口文档(实验)

文章列表接口

/wp-json/zibll_app/v1/posts

请求示例

请求方式

GET

请求头

accept: application/json
User-Agent: bxmaoapp,
Referer:https://www.bxmao.net/.
上述三个字段为可选字段,用于后端鉴权,防盗链过滤非法请求,可在后台插件处自定义,需和app端保持一致,否则将返回403状态码
'Authorization':''//此为用户token,用于获取当前登录用户信息,token过期或错误将返回403状态码,该字段默认为空,获取token需请求token接口,token有效期为24小时

请求字段

  1. id 帖子id(array) 可选,如指定将返回指定id帖子
  2. tag 标签数组(array) 可选,筛选包含指定tag帖子
  3. topic 论坛数组(array) 可选,筛选包含指定论坛帖子
  4. search 搜索字段 (String)可选,搜索指定文本帖子
  5. page 页码 可选(Int),默认为1
  6. userid 用户id(Int) 可选,默认为空,否则返回指定用户id的帖子列表
  7. topping 是否筛选置顶文章 (bool|Sting|Int|),默认空

响应示例

[
    {
        "id": 9,// 文章id
        "time": "8小时前",//发布时间
        "user": {//发布用户信息
            "id": 1,//用户id
            "username": "pand",//用户名称
            "avatar": "",//用户头像
            "backimg": "",//背景图片
            "auth": false,//账号是否认证
            "auth_name": null,//认证名称
            "desc": "",//用户签名
            "vip": 0,//vip等级
            "level": 1,//用户经验等级
            "registered": "2023-01-15 17:35:34",//注册时间
            "lastlogin": "2023-01-16 05:08:13",//登录时间
            "follow": 0,//关注数量
            "followed": 0,//粉丝数量
            "info": [],//用户其他信息
            "isfollow": false//当前登录用户是否关注该用户
        },
        "title": {//帖子标题信息
            "title": "asdasdasd",//标题
            "isEssence": false,//是否加精
            "isTop": 0//是否置顶
        },
        "content": {//帖子正文
            "pay": {//付费信息
                "viewType": "",//允许查看类型
                "payMeta": {//付费信息
                    "pay_type": "no",
                    "pay_limit": "0",
                    "pay_modo": "0",
                    "points_price": "",
                    "vip_1_points": "",
                    "vip_2_points": "",
                    "pay_price": "",
                    "vip_1_price": "",
                    "vip_2_price": "",
                    "pay_rebate_discount": "",
                    "pay_cuont": "",
                    "pay_original_price": "",
                    "promotion_tag": "",
                    "pay_doc": ""
                }
            },
            "imgLists": [],//文章包含图片数组
            "cutContent": "adasdasdasdas",//去除html标签纯文本正文
            "content": "<p>adasdasdasdas</p>\n"//真实文本,如帖子包含隐藏内容,或者登录用户不满足查看条件,则隐藏内容不会显示
        },
        "data": {//帖子元数据
            "star": 0,//收藏数量
            "score": 0,//评分数量
            "commtetNums": 0,//评论数量
            "views": 0,//浏览数量
            "isStar": false,//当前登录用户是否收藏
            "userscore": 0//当前登录用户评分
        },
        "plate": false,//板块信息
        "tag": []//标签数组
    },
    {
        "id": 8,
        "time": "8小时前",
        "user": {
            "id": 1,
            "username": "pand",
            "avatar": "",
            "backimg": "",
            "auth": false,
            "auth_name": null,
            "desc": "",
            "vip": 0,
            "level": 1,
            "registered": "2023-01-15 17:35:34",
            "lastlogin": "2023-01-16 05:08:13",
            "follow": 0,
            "followed": 0,
            "info": [],
            "isfollow": false
        },
        "title": {
            "title": "fafafadfad",
            "isEssence": false,
            "isTop": 0
        },
        "content": {
            "pay": {
                "viewType": "",
                "payMeta": {
                    "pay_type": "no",
                    "pay_limit": "0",
                    "pay_modo": "0",
                    "points_price": "",
                    "vip_1_points": "",
                    "vip_2_points": "",
                    "pay_price": "",
                    "vip_1_price": "",
                    "vip_2_price": "",
                    "pay_rebate_discount": "",
                    "pay_cuont": "",
                    "pay_original_price": "",
                    "promotion_tag": "",
                    "pay_doc": ""
                }
            },
            "imgLists": [],
            "cutContent": "afafasfasf",
            "content": "<p>afafasfasf</p>\n"
        },
        "data": {
            "star": 0,
            "score": 0,
            "commtetNums": 0,
            "views": 0,
            "isStar": false,
            "userscore": 0
        },
        "plate": false,
        "tag": []
    }
]

该接口可能会在后期调整,部分字段在列表页用不到,会移动到帖子详情接口里,

© 版权声明
THE END
喜欢就支持一下吧
分享