API Reference — Lazy Reader

GET /api/articles Public

Lấy danh sách bài đã được thêm qua API (mới nhất lên đầu).

Response

{
  "articles": [
    {
      "id": "art_1746789012345_x8k2m",
      "title": "Tiêu đề bài viết",
      "category": "Danh mục",
      "created_at": "2026-05-09T10:30:00.000Z"
    }
  ]
}

Thử ngay

curl https://lazy.naviplus.work/api/articles

POST /api/articles Cần xác thực

Thêm một bài đọc mới vào danh sách. Bài sẽ xuất hiện ngay trên trang chủ.

Headers

Header	Giá trị	Bắt buộc
`Content-Type`	`application/json`	✓
`Authorization`	`Bearer <API_KEY>`	✓

Request body

Trường	Kiểu	Bắt buộc	Giới hạn
`title`	string	✓	200 ký tự
`content`	string	✓	50.000 ký tự
`category`	string	–	50 ký tự

Ví dụ

curl -X POST https://lazy.naviplus.work/api/articles \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "title": "Tiêu đề bài viết",
    "content": "Nội dung bài viết đầy đủ ở đây...",
    "category": "Danh mục"
  }'

Response — 201 Created

{
  "id": "art_1746789012345_x8k2m",
  "title": "Tiêu đề bài viết",
  "created_at": "2026-05-09T10:30:00.000Z"
}

Thử ngay

API Key Tiêu đề Danh mục Nội dung

Mã lỗi

HTTP	Ý nghĩa
`201`	Tạo thành công
`400`	Thiếu hoặc sai trường dữ liệu
`401`	Sai hoặc thiếu API Key
`503`	Server chưa cấu hình API_KEY hoặc KV binding

Cấu hình server (Cloudflare Pages)

Cần thêm 2 thứ trong Cloudflare Pages → Settings:

1. Environment variable

Tên	Giá trị
`API_KEY`	Chuỗi bí mật tuỳ chọn (dùng làm Bearer token)

2. KV Namespace binding

Vào Workers & Pages → KV → Create namespace → đặt tên lazy_articles.
Sau đó vào Pages project → Settings → KV namespace bindings → Add binding:

Variable name	KV namespace
`ARTICLES_KV`	`lazy_articles`

Redeploy sau khi thêm binding.