Skip to content

Giao tiếp API ​

Mọi lời gọi tới backend từ trình duyệt đều đi qua một Axios instance dùng chung, được RTK Query bọc ở phía trên. Trang này theo dõi đường đi của một request từ lúc thành phần gọi hook đến lúc nhận kết quả, và liệt kê các ngoại lệ không đi qua đường này.

Sơ đồ trình tự: Luồng dữ liệu.

Đường đi của một request ​

text
Thành phần  →  hook (src/hooks)  →  endpoint RTK Query  →  axiosBaseQuery  →  axiosInstance  →  Backend
  1. Thành phần gọi hook, ví dụ useJobList.
  2. Hook gọi endpoint đã sinh bởi RTK Query, ví dụ useSearchJobsQuery.
  3. Endpoint khai báo trong src/features/<miền>/redux/*.api.ts bằng baseApi.injectEndpoints, chỉ mô tả url, method, data hoặc params.
  4. axiosBaseQuery nối API_BASE_URL với url, gọi Axios, rồi đổi kết quả về dạng { data } hoặc { error } mà RTK Query hiểu.
  5. axiosInstance gắn token vào header, gửi request, và xử lý lỗi 401.

Axios instance ​

Cấu hình trong src/lib/axios/axios-instance.ts:

Thiết lậpGiá trị
baseURLAPI_BASE_URL (xem Bối cảnh hệ thống)
timeout10 000 ms
withCredentialstrue, để trình duyệt gửi cookie kèm request

Request interceptor chờ getAccessTokenAsync() (khôi phục phiên hoặc lần làm mới đang chạy) rồi gắn Authorization: Bearer <token>. Nó đặt Content-Type: application/json trừ khi dữ liệu là FormData.

Response interceptor trả thẳng response.data, nên kết quả RTK Query chính là phần thân phản hồi của backend. Khi gặp lỗi 401 nó thử làm mới phiên rồi gửi lại request; cơ chế này mô tả ở Xác thực.

Dạng phản hồi của backend ​

Kiểu ApiResponse<T> trong src/shared/base/api-response.base.ts:

ts
{
  statusCode: number | string;
  message: string | null;
  data?: T;
  timestamp?: string | null;
  error?: string | string[];
}

Danh sách có phân trang trả data dạng PaginatedResult<T> với result và meta.pagination, được dùng ở ví dụ useJobList (total, total_pages). Định nghĩa kiểu ở src/shared/types/pagination.ts.

Xử lý lỗi ​

Khi Axios lỗi, axiosBaseQuery trả error gồm status, data (phần thân lỗi của backend, hoặc thông báo của Axios) và message. Thành phần có thể đọc lỗi qua .unwrap() hoặc trạng thái của hook.

Ngoài ra, middleware authErrorMiddleware đứng trong store và xem mọi action bị từ chối:

Điều kiệnHành vi
Mã 403Hiện toast lỗi, ưu tiên thông báo từ backend
Mã 500Hiện toast lỗi, ưu tiên thông báo từ backend
Thông báo chứa Network ErrorHiện toast lỗi mạng
Mã 400 và 404Chỉ ghi console

Các toast dùng id cố định theo nội dung để cùng một lỗi không hiện chồng nhiều lần.

Những lời gọi không đi qua Axios ​

NơiLý do khác biệt
src/lib/utils/public-content.tsChạy trên server, dùng fetch của Next.js có revalidate. Không có trình duyệt nên không có localStorage
src/features/chatbot/hooks/use-stream-chat.tsCần đọc luồng phản hồi từng đoạn nên dùng fetch; tự gắn Authorization và credentials: "include"
Làm mới token trong axios-instance.tsDùng axios.get trần để không kích hoạt lại interceptor
Socket.IOKết nối WebSocket riêng, xem Giao tiếp thời gian thực

Vì fetch của chat không đi qua interceptor, lỗi 401 ở đó không tự làm mới token; code chọn quay về endpoint REST thường (đi qua Axios) trong trường hợp này.

Source code liên quan ​

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code