Nhảy đến nội dung chính

NHẬP MÔN API

Khái niệm "Nhà Hàng" và Bồi Bàn

Đừng để cái tên dài thòng API (Application Programming Interface - Giao diện lập trình ứng dụng) làm bạn hoang mang. Hãy tưởng tượng bạn đang đi ăn ở một nhà hàng:

  • Bạn (Client / Ứng dụng điện thoại): Bạn ngồi ở bàn, xem menu và biết mình muốn ăn gì (Bạn cần dữ liệu).
  • Nhà bếp (Server / Database - Cơ sở dữ liệu): Nơi chứa nguyên liệu và nấu ra món ăn (Nơi chứa dữ liệu).
  • Người Bồi Bàn (Chính là API): Bạn không thể tự chạy tọt vào bếp để nấu hay lấy đồ ăn. Bạn phải gọi bồi bàn. Bồi bàn sẽ ghi lại yêu cầu của bạn, chạy vào bếp báo lại, chờ bếp làm xong rồi bưng món ăn ra bàn cho bạn.

=> Tóm lại: API chính là "anh bồi bàn" giúp hai hệ thống phần mềm (ứng dụng của bạn và máy chủ) nói chuyện và trao đổi dữ liệu với nhau một cách an toàn.

1. Bốn Hành Động Cơ Bản Của API 

Anh bồi bàn API có 4 phương thức (Method) làm việc tương ứng:

  • GET (Lấy thông tin): Giống lệnh SELECT trong SQL.

    • Ví dụ: Bạn xin bồi bàn cuốn Menu. Bạn chỉ "xem" chứ không thay đổi gì cả. Lên mạng đọc báo, lướt Facebook xem ảnh... tất cả đều đang dùng lệnh GET.

  • POST (Gửi / Thêm mới): Giống lệnh INSERT trong SQL.

    • Ví dụ: Bạn "chốt đơn" và gửi yêu cầu nấu món mới vào bếp. Khi bạn đăng một bức ảnh mới lên mạng hay tạo tài khoản mới, bạn đang dùng POST.

  • PUT / PATCH (Cập nhật / Sửa): Giống lệnh UPDATE trong SQL.

    • Ví dụ: Món ăn đang làm, nhưng bạn gọi bồi bàn lại và bảo: "Cho anh thêm ít ớt vào bát phở nhé". Bạn đang sửa thông tin đã có.

  • DELETE (Xóa): Giống lệnh DELETE trong SQL.

    • Ví dụ: Bạn đổi ý và bảo bồi bàn hủy món đó đi.

2. API "mang đồ ăn ra" bằng cái gì? (Định dạng JSON)JSON

Người bồi bàn dùng cái khay để bưng đồ ăn. Còn API thì thường dùng một "cái khay" có tên là JSON để bưng dữ liệu.

JSON là một định dạng chữ cực kỳ dễ đọc. Nó luôn đi theo từng cặp "Tên_thuộc_tính": "Giá_trị".

Ví dụ, bồi bàn API mang thông tin một người dùng ra cho bạn bằng khay JSON sẽ trông như thế này:

JSON 
{
  "ID_NhanVien": 101,
  "HoTen": "Nguyễn Văn A",
  "VaiTro": "Lập trình viên",
  "DangHoatDong": true
}

Nhìn rất dễ hiểu, đúng không nào?

3. Các Mã Trạng Thái (Status Code) - Bồi bàn trả lời bạn thế nào?

Sau khi bạn gọi món, bồi bàn sẽ báo lại tình hình cho bạn bằng các con số gồm 3 chữ số (Gọi là Status Code). Đây là các mã phổ biến nhất bạn bắt buộc phải biết:

  • 🟢 Mã 200 (OK): "Thành công rồi nhé! Đồ ăn của quý khách đây." (Tuyệt vời, API hoạt động tốt và đã trả về dữ liệu).liệu.

  • 🟡 Mã 400 (Bad Request): "Anh ghi nhầm tên món rồi, bếp không hiểu anh muốn gọi gì." (Lỗi do bạn gửi sai dữ liệu, sai định dạng).dạng.

  • 🟠 Mã 404 (Not Found): "Xin lỗi, quán em không có món này." (Đường dẫn API không tồn tại hoặc dữ liệu bạn tìm đã bị xóa).xóa.

  • 🔴 Mã 500 (Internal Server Error): "Cháy bếp rồi!!! Lỗi do nhà hàng chứ không phải do anh." (Máy chủ bị sập hoặc code của lập trình viên bị lỗi).lỗi.

💡 Mẹo nhớ nhanh: > * Số bắt đầu bằng 2xx: Thành công.

  • Số bắt đầu bằng 4xx: Lỗi do người dùng (Client).

  • Số bắt đầu bằng 5xx: Lỗi do hệ thống máy chủ (Server).

Lên đầu trang