Laravel làm backend API cho ứng dụng React, Vue, di động rất thuận tiện. Bài này tạo API REST, chuẩn hóa dữ liệu trả về bằng API Resource và xác thực bằng token Sanctum.

60 phútNâng cao
Bạn sẽ học được
  • Cài API: php artisan install:api
  • Route API và API Resource
  • Xác thực token với Sanctum
  • Phân trang, mã trạng thái

Cơ sở lý thuyết

Khi frontend là ứng dụng React/Vue hoặc ứng dụng di động, backend chỉ cung cấp API trả JSON. Khác biệt so với website truyền thống:

  • Không trạng thái: mỗi yêu cầu tự mang thông tin xác thực (token) thay vì dựa vào phiên.
  • Sanctum cung cấp hai cơ chế: token API (chuỗi ngẫu nhiên lưu dạng băm trong CSDL, gửi trong header Authorization: Bearer) cho ứng dụng di động; xác thực SPA bằng cookie cho frontend cùng tên miền gốc.
  • API Resource là tầng biến đổi model thành JSON: chọn trường công khai, đổi tên, định dạng ngày, ẩn dữ liệu nhạy cảm; tách cấu trúc CSDL khỏi hợp đồng API.
  • Phiên bản API (/api/v1) để thay đổi không làm hỏng ứng dụng di động phiên bản cũ.
  • Khả năng của token (abilities) giới hạn token chỉ được làm một số việc – nguyên tắc đặc quyền tối thiểu.

API

php artisan install:api

// routes/api.php
Route::post('/dang-nhap', [AuthController::class, 'dangNhap']);
Route::middleware('auth:sanctum')->group(function () {
    Route::apiResource('sinhvien', Api\SinhVienController::class);
});

// Api\SinhVienController
public function index() { return SinhVienResource::collection(SinhVien::paginate(20)); }
public function store(SinhVienRequest $r) {
    return (new SinhVienResource(SinhVien::create($r->validated())))->response()->setStatusCode(201);
}

Đăng nhập trả token

public function dangNhap(Request $r)
{
    $user = User::where('email', $r->email)->first();
    if (!$user || !Hash::check($r->password, $user->password))
        return response()->json(['message' => 'Sai thông tin đăng nhập'], 401);
    return ['token' => $user->createToken('app')->plainTextToken];
}
// Ứng dụng gửi kèm: Authorization: Bearer <token>

Ứng dụng thực tế

Bài toán: ứng dụng di động tra cứu điểm cho sinh viên. API trả điểm của chính sinh viên đang đăng nhập, không bao giờ để lộ thông tin sinh viên khác, và chỉ trả trường cần thiết:

// routes/api.php
Route::middleware('auth:sanctum')->get('/v1/diem-cua-toi', function (Request $r) {
    return KetQuaResource::collection(
        $r->user()->sinhVien->ketQuas()->with('monHoc')->latest('hoc_ky')->get()
    );
});

class KetQuaResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            'mon' => $this->monHoc->ten,
            'tin_chi' => $this->monHoc->tin_chi,
            'diem_10' => $this->diem,
            'diem_chu' => $this->diem_chu,
            'hoc_ky' => $this->hoc_ky,
        ];   // không trả ghi chú nội bộ, người nhập điểm...
    }
}
Mẹo hay

Xem loạt REST API và bảo mật web để thiết kế API đúng chuẩn.

Thực hành
  1. Tạo API CRUD sinh viên.
  2. Thử API bằng Postman.
  3. Gọi API từ ứng dụng React hoặc Vue.
Tóm tắt bài học
  • routes/api.php cho API.
  • API Resource định dạng JSON.
  • Sanctum xác thực bằng token.