API Công Khai: Dành Cho Người Mới!

Chào các bạn, mình lại đây nè! 👋

Nếu bạn là người mới bắt đầu học lập trình, đặc biệt là phát triển web, chắc hẳn đã từng “đau đầu” vì không biết tìm đâu ra API thực tế để luyện tập, đúng không? Tự tạo thì vừa tốn kém vừa phức tạp, còn dùng API miễn phí thì không biết bắt đầu từ đâu. Đừng lo nhé, hôm nay mình sẽ dẫn bạn đến một sân chơi miễn phí siêu vui để thoải mái rèn kỹ năng gọi API: đó chính là các API công khai trên blog và portfolio của mình tại https://duonguyen.site/api!

API Công Khai Là Gì Và Tại Sao Người Mới Nên Thử Ngay?

Nói đơn giản, API (Application Programming Interface) giống như một “nhân viên phục vụ” trong nhà hàng. Bạn “gọi món” (gửi request), và API sẽ “mang món ăn” (trả về dữ liệu) cho bạn. Trong lập trình web, bạn sẽ thường dùng API để lấy dữ liệu từ server và hiển thị lên trang web của mình.

Thực hành với API không chỉ thú vị mà còn giúp bạn nắm vững những kỹ năng quan trọng như:

• Gửi request: Dùng các phương thức như GET, POST, PUT, PATCH, DELETE để giao tiếp với server.
• Nhận response: Thường là dữ liệu dạng JSON, dễ đọc và xử lý.
• Xử lý dữ liệu: Biến dữ liệu thô thành nội dung hiển thị đẹp mắt.
• Hiểu HTTP status codes: Biết được request của bạn thành công hay thất bại.
• Làm việc với tham số: Dùng query hay path parameters để tùy chỉnh yêu cầu.

Các API công khai tại https://duonguyen.site/api hoàn toàn miễn phí, được thiết kế siêu đơn giản, cực kỳ thân thiện với người mới. Mình đã xây dựng backend bằng Next.js, Express.js, và dùng Postgresql với Prisma ORM, nên bạn sẽ được trải nghiệm một hệ thống thực tế mà không cần lo lắng gì cả!

Khám Phá Các API Công Khai: Có Gì Đỉnh Cao Đang Chờ Bạn?

Hãy cùng mình “đào kho báu” trong danh sách API này nhé, đảm bảo bạn sẽ thích mê!

1. API “Hello World” Siêu Dễ: /api

Đây là “cửa ải” đầu tiên dành cho bạn, đơn giản như một cái vẫy tay chào hỏi. Chỉ cần gọi endpoint này, bạn sẽ nhận được một lời nhắn thân thiện để kiểm tra xem mọi thứ hoạt động ngon lành chưa.

Endpoint: /api
Method: GET
Mô tả: Trả về một lời chào đơn giản để bạn làm quen với API.
Response:

2. API Blog: /api/blogs – Kho Báu Cho Người Thích Viết Lách

Muốn thử xây một ứng dụng đọc blog? API này là “trợ thủ đắc lực” của bạn! Bạn có thể lấy danh sách bài viết, lọc theo tag, tìm kiếm, phân trang, hay xem chi tiết từng bài.

Lấy Danh Sách Tags

Endpoint: /api/blogs/tags
Method: GET
Mô tả: Lấy tất cả các tag của blog – hữu ích để tạo bộ lọc.
Tham số hỗ trợ:

• search hoặc q (tùy chọn): Tìm tag theo tên, ví dụ: https://duonguyen.site/api/blogs/tags?search=javascript.

Mẹo: Không thêm tham số thì bạn sẽ nhận toàn bộ danh sách tag nhé!

Response:

Lấy Danh Sách Blog

Endpoint: /api/blogs
Method: GET
Mô tả: Lấy danh sách bài viết – bạn có thể tùy chỉnh theo ý thích!
Tham số hỗ trợ:

• limit: Số bài tối đa mỗi trang (mặc định 9). Ví dụ: https://duonguyen.site/api/blogs?limit=1&page=1.
• page: Số trang (bắt đầu từ 1).
• tag: Lọc theo tag, như https://duonguyen.site/api/blogs?tag=javascript.
• id: Lấy bài cụ thể, ví dụ: https://duonguyen.site/api/blogs/xin-chao-cac-ban-minh-la-duong.
• search hoặc q: Tìm kiếm theo tiêu đề/nội dung, như https://duonguyen.site/api/blogs?search=javascript.

Response:

Lấy Chi Tiết Blog

Endpoint: /api/blogs/[id] (thay [id] bằng ID bài viết)
Method: GET
Mô tả: Xem toàn bộ nội dung của một bài blog – lý tưởng để hiển thị bài viết đầy đủ!

Response:

Lấy Bình Luận Blog

Endpoint: /api/blogs/[id]/comments
Method: GET
Mô tả: Lấy danh sách bình luận của bài viết – thử làm một mục bình luận cho blog xem sao nhé!
Tham số hỗ trợ:

• limit: Số bình luận tối đa (mặc định 10).
• page: Số trang. Ví dụ: https://duonguyen.site/api/blogs/xin-chao-cac-ban-minh-la-duong/comments?limit=1&page=1.

Response:

3. API Người Dùng: /api/users – Tìm Hiểu Dữ Liệu User

Thích khám phá cách quản lý người dùng? API này cho bạn thông tin công khai (đã ẩn danh) về user trên trang.

Lấy Danh Sách hoặc Một User

Endpoint: /api/users
Method: GET
Mô tả: Lấy tất cả user hoặc một người cụ thể.
Tham số hỗ trợ:

• id: Lấy theo ID, như https://duonguyen.site/api/users?id=tester.
• email: Lấy theo email (có thể cần xác thực), ví dụ: https://duonguyen.site/api/[email protected].

Response:

Lấy User Theo ID

Endpoint: /api/users/[id]
Method: GET
Mô tả: Lấy thông tin chi tiết một user theo ID.

Response:

4. API Thông Tin Trang: /api/info – Dữ Liệu Chung Siêu Hữu Ích

Cần thông tin tổng quan về trang web? API này cung cấp mọi thứ từ tên trang đến cấu hình công khai.

Lấy Thông Tin Chung

Endpoint: /api/info
Method: GET
Mô tả: Lấy thông tin chính của trang – thử dùng để tùy chỉnh giao diện nhé!

Response:

Lấy Thông Tin Theo Khóa

Endpoint: /api/info/[param] (ví dụ: siteName)
Method: GET
Mô tả: Lấy dữ liệu cụ thể theo khóa – cực kỳ tiện lợi!

Response:

Còn Nhiều Điều Thú Vị Khác Trên https://duonguyen.site Đang Chờ Bạn!

Ngoài các API “nhỏ mà có võ” trên, trang của mình còn có những dự án đỉnh cao khác như:

• Shop API: Phân tích API cho một sàn thương mại điện tử đơn giản với đầy đủ đăng ký, giỏ hàng, thanh toán, v.v.
• Countries API: Cung cấp dữ liệu quốc gia, thành phố – tuyệt vời để làm ứng dụng bản đồ!

Mình cũng có tổng hợp một số kinh nghiệm học lập trình, kiến thức JavaScript từ cơ bản đến nâng cao qua series “Javascript Tuyển Tập”, và cả cách setup server nữa. Tất cả đều để giúp bạn – những coder mới – có thêm tài liệu và cảm hứng trên hành trình lập trình!

Kết Luận: Bắt Đầu Thôi Nào!

Thực hành là cách nhanh nhất để giỏi lập trình, và các API công khai tại https://duonguyen.site chính là “bạn đồng hành” lý tưởng cho người mới. Chúng miễn phí, dễ dùng, và sẵn sàng để bạn khám phá.

Hãy thử gửi request, nghịch ngợm với tham số, và xem dữ liệu trả về như thế nào nhé. Bạn sẽ học được khối thứ hay ho đấy!

Chúc bạn học vui, code “đã”, và nếu có thắc mắc gì thì cứ liên hệ mình nha!

Bài viết được viết ngày 24 ngày trước, mình sẽ cập nhật thêm API mới nên nhớ ghé lại thường xuyên nhé! 😉