API và Webhook: Kiến Thức Cơ Bản Bạn Cần Biết Trước Khi Xây Dựng Workflow

API là gì? Giải thích bằng ví dụ đơn giản (00:00-04:10)

API (Application Programming Interface) là một khái niệm quan trọng mà bất kỳ ai muốn tự động hóa workflow đều cần nắm vững. Nhưng thay vì đi vào định nghĩa khô khan, mình sẽ bắt đầu với một ví dụ quen thuộc mà ai cũng có thể hiểu được.

Tương tự như vậy, khi bạn muốn lấy dữ liệu từ Google Sheets (nhà bếp/application), bạn không trực tiếp “đi vào bếp” để lấy dữ liệu, mà sẽ thông qua “người phục vụ” – chính là API!

Cách thức hoạt động của API (04:11-06:10)

API giúp chúng ta “trừu tượng hóa” sự phức tạp của ứng dụng. Tưởng tượng nếu mỗi lần muốn đọc dữ liệu từ Google Sheets, bạn phải trực tiếp truy cập vào server của Google, tìm sheet cụ thể và đọc dữ liệu – quá phức tạp phải không nào?

Trong n8n, bạn sẽ thấy node HTTP Request – đây chính là công cụ để bạn gửi các yêu cầu API và nhận phản hồi từ các ứng dụng khác nhau.

HTTP Request: Các thành phần chính (06:11-11:15)

Khi gửi một HTTP request, bạn cần hiểu 4 thành phần chính. Hãy xem chúng giống như gì trong thực tế nhé!

1. URL (Uniform Resource Locator)

URL là địa chỉ duy nhất của tài nguyên trên web. Ví dụ: https://api.example.com:8080/users?id=123

2. Method

Method mô tả hành động bạn muốn thực hiện. Chúng thường là các động từ, giúp bạn dễ dàng hiểu mục đích của request.

3. Header

Header cung cấp thông tin bổ sung về request của bạn. Ví dụ về vị trí, ngôn ngữ, loại thiết bị, hoặc định dạng dữ liệu mà bạn muốn nhận.

Ví dụ: Accept: application/json – Yêu cầu server trả về dữ liệu dạng JSON.

4. Body

Body chứa thông tin bạn muốn gửi đến server, chỉ được sử dụng cho một số method như POST. Ví dụ khi gửi form đăng ký:

{
  "firstName": "Maxim",
  "lastName": "Poon",
  "email": "example@email.com"
}
    

Xác thực (Authentication)

Để bảo mật, hầu hết API đều yêu cầu xác thực – chứng minh bạn có quyền truy cập vào dữ liệu.

HTTP Response: Nhận và xử lý phản hồi (11:16-13:35)

Khi bạn gửi request đi, server sẽ xử lý và trả về response. Giống như việc đặt món ăn và nhận lại món ăn từ nhà hàng vậy!

1. Status Code

Status code là số 3 chữ số cho bạn biết request của bạn có thành công hay không và nếu không, lý do là gì.

Mẹo nhỏ: Status code bắt đầu bằng 2xx = thành công, 4xx = lỗi từ phía bạn, 5xx = lỗi từ phía server.

2. Header

Tương tự như request header, response header cung cấp thông tin thêm về dữ liệu được trả về.

Ví dụ: Kích thước nội dung, loại nội dung, thời gian hết hạn…

3. Body

Body chứa dữ liệu thực tế mà server trả về. Nó có thể ở nhiều định dạng khác nhau:

• HTML (khi bạn duyệt web)
• JSON (phổ biến nhất cho API)
• Dữ liệu nhị phân (hình ảnh, file,…)

Webhook (Reverse API): Cách thức hoạt động (13:36-15:30)

Webhook còn được gọi là “Reverse API”. Thay vì bạn phải liên tục “hỏi” server xem có gì mới không, server sẽ chủ động “báo” cho bạn khi có sự kiện xảy ra.

Ứng dụng thực tế với Stripe

Giả sử bạn cần biết khi nào có thanh toán mới trên Stripe:

Để thiết lập webhook, bạn cần:

• URL nơi bạn muốn nhận thông tin
• Công cụ như n8n và node Webhook để xử lý thông tin nhận được