Tài liệu API

GET/api/posts

Lấy danh sách bài viết

Trả về danh sách bài viết được phân trang. Hỗ trợ chọn số trang và số bài mỗi trang.

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định	Mô tả
page	query	number	Không	1	Số trang cần lấy, bắt đầu từ 1.
limit	query	number	Không	10	Số bài viết trên mỗi trang. Giá trị hợp lệ: 1 đến 100.

Ví dụ request

curl https://www.nguyenduongthevi.click/api/posts?page=1&limit=10

Ví dụ response

{
    "success": true,
    "message": "Posts fetched",
    "data": {
        "items": [
            {
                "slug": "7-a3-injection-cross-site-scripting",
                "title": "A3 — Injection: Cross-Site Scripting",
                "date": "2024-05-12",
                "description": "Tổng quan về tấn công XSS và cách phòng tránh...",
                "tags": [
                    "security",
                    "owasp",
                    "xss"
                ],
                "thumbnail": "/posts/xss.jpg",
                "readTime": "6",
                "author": "Nguyễn Dương Thế Vĩ"
            }
        ],
        "totalItems": 23,
        "page": 1,
        "perPage": 10,
        "totalPages": 3
    }
}

Thử ngay

GET/api/posts/{slug}

Xem chi tiết một bài viết

Trả về frontmatter và nội dung HTML đã render của bài viết theo slug.

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định	Mô tả
slug	path	string	Có	—	Slug duy nhất của bài viết, gồm chữ thường, số và dấu gạch nối.

Ví dụ request

curl https://www.nguyenduongthevi.click/api/posts/7-a3-injection-cross-site-scripting

Ví dụ response

{
    "success": true,
    "message": "Post fetched",
    "data": {
        "slug": "7-a3-injection-cross-site-scripting",
        "title": "A3 — Injection: Cross-Site Scripting",
        "date": "2024-05-12",
        "description": "Tổng quan về tấn công XSS và cách phòng tránh...",
        "tags": [
            "security",
            "owasp",
            "xss"
        ],
        "thumbnail": "/posts/xss.jpg",
        "readTime": "6",
        "author": "Nguyễn Dương Thế Vĩ",
        "contentHtml": "<h2>Giới thiệu</h2><p>...</p>"
    }
}

Thử ngay

Tài liệu API

Tổng quan

Danh sách endpoint

Lấy danh sách bài viết

Tham số

Ví dụ request

Ví dụ response

Xem chi tiết một bài viết

Tham số

Ví dụ request

Ví dụ response