Postman Collection - Dành cho Sinh Viên

Test API dễ dàng với Postman - Hướng dẫn bằng Tiếng Việt!

⬇️ Tải Collection về máy

Collection dành riêng cho sinh viên với 5 API endpoints và hướng dẫn tiếng Việt

📥 Tải Postman Collection cho Sinh Viên 🚀 Tải Postman (nếu chưa có)

📦 Collection này bao gồm:

�

Xem Bài Viết

Lấy tất cả hoặc chi tiết bài viết

➕

Tạo Mới

Thêm bài viết với title và body

✏️

Chỉnh Sửa

Cập nhật nội dung bài viết

�️

Xóa Bài Viết

Xóa bài viết khỏi hệ thống

🎯 Hướng dẫn sử dụng

1

Cài đặt Postman

Nếu chưa có Postman, tải về từ trang chủ:

👉 https://www.postman.com/downloads/

Postman hỗ trợ: Windows, macOS, Linux
Hoặc sử dụng Postman Web (không cần cài đặt)

2

Tải Collection JSON

Click nút "📥 Tải Postman Collection" ở trên để tải file JSON về máy.

File sẽ được lưu với tên: REST_API_Post_Collection.postman_collection.json

3

Import vào Postman

Mở Postman và làm theo các bước:

  • Click nút "Import" ở góc trên bên trái
  • Kéo thả file JSON vào hoặc click "Select Files"
  • Chọn file REST_API_Post_Collection.postman_collection.json
  • Click "Import" để hoàn tất
4

Cấu hình MSSV (Username)

Sau khi import, cần thay đổi biến username:

  • Click vào collection "REST API Post - Dành cho Sinh Viên"
  • Chọn tab "Variables" ở góc phải
  • Thay giá trị 2021600001 thành MSSV thật của bạn
  • Click "Save" (Ctrl+S)
username = 2021600001 → username = [MSSV của bạn]

⚠️ Quan trọng: MSSV phải được admin cấp quyền trước khi sử dụng!

5

Bắt đầu Test API

Bây giờ bạn có thể test các API theo thứ tự:

  • � 1. Xem Tất Cả Bài Viết - Kiểm tra danh sách hiện có
  • ➕ 3. Tạo Bài Viết Mới - Thử tạo bài viết đầu tiên
  • 👁️ 2. Xem Chi Tiết - Xem nội dung bài vừa tạo
  • ✏️ 4. Chỉnh Sửa - Cập nhật nội dung
  • 🗑️ 5. Xóa - Xóa bài viết (cẩn thận!)

Mỗi request có hướng dẫn chi tiết bằng tiếng Việt trong phần Description!

⚠️ Lưu ý quan trọng cho sinh viên:

📖 5 API Endpoints dành cho Sinh Viên:

  • 📋 1. Xem Tất Cả Bài Viết - Lấy danh sách bài viết của bạn (chỉ hiển thị ID + Title)
  • 👁️ 2. Xem Chi Tiết Bài Viết - Xem đầy đủ nội dung một bài viết (cần ID)
  • ➕ 3. Tạo Bài Viết Mới - Tạo bài viết với title và body (tối đa 5 bài/phút)
  • ✏️ 4. Chỉnh Sửa Bài Viết - Cập nhật title và body của bài viết hiện có
  • 🗑️ 5. Xóa Bài Viết - Xóa vĩnh viễn bài viết (không thể hoàn tác!)

💡 Mẹo học tập: Thử test theo thứ tự 1→3→2→4→5 để hiểu rõ flow hoạt động của API!

💡 Tips cho Sinh Viên

�

Đọc Description của mỗi Request

Mỗi endpoint có hướng dẫn chi tiết bằng tiếng Việt với:

  • 🎯 Mục đích của API
  • 📝 Cách sử dụng từng bước
  • ✅ Ví dụ kết quả thành công
  • ❌ Các lỗi thường gặp và cách fix
�

Thử theo Flow Chuẩn

Thứ tự nên test để hiểu rõ cách API hoạt động:

  1. Xem tất cả bài viết hiện có
  2. Tạo bài viết mới
  3. Xem chi tiết bài vừa tạo
  4. Chỉnh sửa nội dung
  5. Xóa bài viết test
⚠️

Xử lý Lỗi 403

Nếu nhận được lỗi 403 Forbidden:

  • Kiểm tra MSSV đã đúng chưa (tab Variables)
  • Xem MSSV đã được admin cấp quyền chưa
  • Liên hệ giáo viên để được thêm vào hệ thống
�

Lưu Kết Quả

Sau khi test thành công, bạn có thể:

  • Click "Save Response" để lưu example
  • Chụp màn hình kết quả làm bằng chứng nộp bài
  • Copy JSON response để phân tích cấu trúc dữ liệu

🔗 Links hữu ích cho Sinh Viên:

REST API Post - Postman Collection cho Sinh Viên

Developed by Bùi Phú Khuyên | Version 2.0 - Student Edition

Base URL: https://buiphukhuyen.io.vn/api/post

📥 Tải Collection cho Sinh Viên | 🚀 Tải Postman | 📖 Xem Docs