Get post list | 获取帖子列表

Get post list with pagination and sorting support. Only returns posts with Normal or Locked status. Content is hidden in list view. Supports filtering by category (via ID or slug) and keyword search on title. Pinned posts are returned separately in pinned_posts field | 获取帖子列表,支持分页和排序。只返回正常或锁定状态的帖子。列表中内容已隐藏。支持通过版块ID或slug筛选,以及标题关键词搜索。置顶帖子单独返回在pinned_posts字段中

返回响应

🟢200成功

application/json

Retrieved successfully | 获取成功

Body

示例

{
    "code": 20000,
    "data": {
        "page": 0,
        "page_size": 0,
        "pinned_posts": [
            {
                "avatar": "string",
                "category_id": 0,
                "category_name": "string",
                "content": "string",
                "created_at": "string",
                "dislike_count": 0,
                "favorite_count": 0,
                "id": 0,
                "is_essence": true,
                "is_pinned": true,
                "like_count": 0,
                "read_permission_points": 0,
                "read_permission_type": "string",
                "status": "string",
                "title": "string",
                "updated_at": "string",
                "user_disliked": true,
                "user_favorited": true,
                "user_id": 0,
                "user_liked": true,
                "username": "string",
                "view_count": 0
            }
        ],
        "posts": [
            {
                "avatar": "string",
                "category_id": 0,
                "category_name": "string",
                "content": "string",
                "created_at": "string",
                "dislike_count": 0,
                "favorite_count": 0,
                "id": 0,
                "is_essence": true,
                "is_pinned": true,
                "like_count": 0,
                "read_permission_points": 0,
                "read_permission_type": "string",
                "status": "string",
                "title": "string",
                "updated_at": "string",
                "user_disliked": true,
                "user_favorited": true,
                "user_id": 0,
                "user_liked": true,
                "username": "string",
                "view_count": 0
            }
        ],
        "total": 0,
        "total_pages": 0
    },
    "err_code": "string",
    "msg": null
}

🟠400请求有误

🔴500服务器内部错误

Get post list | 获取帖子列表

请求参数

请求示例代码

返回响应