🦐 API Documentation

Hệ thống Bán Hải Sản - REST API

Base URL: https://backendfish.mnhwua.id.vn/api

1. API Danh Mục

Method Endpoint Mô tả
GET /danh-muc Lấy tất cả danh mục
POST /danh-muc Tạo danh mục mới
GET /danh-muc/{id} Xem chi tiết danh mục
PUT /danh-muc/{id} Cập nhật danh mục
DELETE /danh-muc/{id} Xóa danh mục
📝 Request Body - Tạo Danh Mục:
{
  "ten_danh_muc": "Hải sản tươi sống",
  "mo_ta": "Các loại hải sản tươi ngon"
}

2. API Sản Phẩm

Method Endpoint Mô tả
GET /san-pham Lấy danh sách sản phẩm (có filter: ma_danh_muc, hien_thi, search)
POST /san-pham Tạo sản phẩm mới
GET /san-pham/{id} Xem chi tiết sản phẩm
PUT /san-pham/{id} Cập nhật sản phẩm
DELETE /san-pham/{id} Xóa sản phẩm
📝 Request Body - Tạo Sản Phẩm:
{
  "ma_danh_muc": 1,
  "ten_san_pham": "Tôm sú tươi",
  "mo_ta": "Tôm sú tươi ngon size lớn",
  "gia_ban": 350000,
  "hinh_anh": "https://example.com/image.jpg",
  "so_luong_ton": 50,
  "hien_thi": true
}
💡 Query Params:
  • ma_danh_muc - Lọc theo danh mục
  • hien_thi - Lọc theo trạng thái hiển thị (0/1)
  • search - Tìm kiếm theo tên sản phẩm
Ví dụ:
https://backendfish.mnhwua.id.vn/api/san-pham?ma_danh_muc=1&hien_thi=1&search=tôm

3. API Người Dùng

Method Endpoint Mô tả
GET /nguoi-dung Lấy danh sách người dùng
POST /nguoi-dung Đăng ký người dùng mới
GET /nguoi-dung/{id} Xem chi tiết người dùng + đơn hàng
PUT /nguoi-dung/{id} Cập nhật thông tin người dùng
DELETE /nguoi-dung/{id} Xóa người dùng
📝 Request Body - Đăng ký Người Dùng:
{
  "ho_ten": "Nguyễn Văn A",
  "email": "nguyenvana@example.com",
  "mat_khau": "password123",
  "so_dien_thoai": "0901234567",
  "dia_chi": "123 Đường ABC, Quận 1, TP.HCM"
}

4. API Đơn Hàng

Method Endpoint Mô tả
GET /don-hang Lấy danh sách đơn hàng (có filter: ma_nguoi_dung, trang_thai)
POST /don-hang Tạo đơn hàng mới (tự động tính tổng tiền)
GET /don-hang/{id} Xem chi tiết đơn hàng
PUT /don-hang/{id} Cập nhật trạng thái đơn hàng
DELETE /don-hang/{id} Xóa đơn hàng
📝 Request Body - Tạo Đơn Hàng:
{
  "ma_nguoi_dung": 1,
  "dia_chi_giao_hang": "123 Đường XYZ, Quận 1, TP.HCM",
  "ghi_chu": "Giao hàng buổi chiều",
  "chi_tiet": [
    {
      "ma_san_pham": 1,
      "so_luong": 2
    },
    {
      "ma_san_pham": 3,
      "so_luong": 1
    }
  ]
}
📊 Trạng thái đơn hàng:
  • pending - Chờ xử lý
  • processing - Đang xử lý
  • completed - Hoàn thành
  • cancelled - Đã hủy

5. API Thanh Toán

Method Endpoint Mô tả
GET /thanh-toan Lấy danh sách thanh toán (có filter: trang_thai, phuong_thuc)
POST /thanh-toan Tạo thanh toán mới
GET /thanh-toan/{id} Xem chi tiết thanh toán
PUT /thanh-toan/{id} Cập nhật trạng thái thanh toán
DELETE /thanh-toan/{id} Xóa thanh toán
📝 Request Body - Tạo Thanh Toán:
{
  "ma_don_hang": 1,
  "phuong_thuc": "credit_card",
  "so_tien": 1500000,
  "noi_dung": "Thanh toán đơn hàng #1"
}
💳 Phương thức thanh toán:
  • cash - Tiền mặt
  • credit_card - Thẻ tín dụng
  • bank_transfer - Chuyển khoản
  • e_wallet - Ví điện tử
📊 Trạng thái thanh toán:
  • pending - Chờ thanh toán
  • completed - Đã thanh toán
  • failed - Thất bại
  • refunded - Đã hoàn tiền

📤 Response Format

Success Response:
{
  "success": true,
  "data": {...} hoặc [...]
}
Error Response:
{
  "success": false,
  "message": "Thông báo lỗi chi tiết"
}
⚠️ HTTP Status Codes:
  • 200 - OK (Thành công)
  • 201 - Created (Tạo mới thành công)
  • 404 - Not Found (Không tìm thấy)
  • 422 - Unprocessable Entity (Lỗi validation)
  • 500 - Internal Server Error (Lỗi server)

© 2025 Hệ thống Bán Hải Sản - Laravel API Documentation