API là gì? Hướng dẫn API toàn tập · Tập 3
Webhook và tích hợp văn phòng
MỞ ĐẦU Đọc sách này thế nào Tập 3 đưa API vào quy trình: dữ liệu tự chảy vào bảng tính, sự kiện tự tạo bản nháp, và mọi thứ có người trông. Bạn có thể tới đây từ Tập 1 nếu muốn dùng công cụ không code như n8n, hoặc từ Tập 2 nếu đã quen Pyth...
Mục lục & Cấu trúc thực hành (12 phần)
- Trang tên sách Trang 2
- Đọc sách này thế nào Trang 4
- Chương 1. Webhook là gì: khi hệ thống gọi lại cho bạn Trang 5
- Chương 2. Kết nối API với Google Sheets đúng chiều và đúng quyền Trang 13
- Chương 3. Một quy trình qua n8n, Make hoặc Zapier Trang 19
- Chương 4. Dự án cuối: kiểm thử, bàn giao và dùng lâu dài Trang 26
- Bảng kiểm một trang Trang 32
- Từ điển Việt Anh Trang 34
- Phụ lục A. Mã nguồn, workflow và nhật ký Trang 35
- Phụ lục B. Nguồn video và tài liệu Trang 44
- Phụ lục C. Những điểm chưa xác minh Trang 46
- Học tiếp cùng Minh Đỗ Trang 47
Nội dung mở đầu & Trích đoạn đọc thử
BỘ SÁCH 3 TẬP API là gì? Hướng dẫn API toàn tập Tập 3 Webhook và tích hợp văn phòng by Minh Đỗ Sách độc lập, không liên kết với Anthropic, OpenAI, Google, Postman, Bruno hay n8n, không được các bên này tài trợ hay xác nhận. Claude là nhãn hiệu của Anthropic; ChatGPT và OpenAI của OpenAI; Gemini và Google Sheets của Google; Postman của Postman, Inc.; Bruno là nhãn hiệu do Anoop M D nắm giữ; n8n của chủ sở hữu n8n. Logo Bruno gốc từ OpenMoji, giấy phép CC BY-SA 4.0. Mọi công ty, tên người, sản phẩm, đơn hàng, khoản chi và khóa trong sách là dữ liệu giả lập do tác giả tự tạo. Không có khóa thật, tài khoản thật hay lần gọi API tính phí nào trong quá trình viết sách. Tài liệu chính thức kiểm ngày 10/11/2026 (giờ Việt Nam, UTC+7). Giá, tên model, gói dịch vụ và giao diện có thể đổi sau ngày này; sách cố ý không ghi giá và tên model, chỉ trỏ tới trang chính thức. Video trong sách thuộc tác giả và kênh tương ứng. Sách chỉ dẫn link tới đúng đoạn, không cắt, tải lại hay đăng lại video.
MỤC LỤC Mục lục MỞ ĐẦU Đọc sách này thế nào Đi từ Tập 1 hay Tập 2, đã chạy gì 4 CHƯƠNG 1 Webhook là gì: khi hệ thống gọi lại cho bạn Chữ ký, phát lại, trùng, sai thứ tự 5 CHƯƠNG 2 Kết nối API với Google Sheets đúng chiều và đúng quyề n Apps Script, Sheets API, chống ghi trùng 13 CHƯƠNG 3 Một quy trình qua n8n, Make hoặc Zapier Credential, phân trang, webhook test và thật 19 CHƯƠNG 4 Dự án cuối: kiểm thử, bàn giao và dùng lâu dài Ma trận kiểm thử, phiếu bàn giao, vận hành 26 BẢNG KIỂM Bảng kiểm một trang Trước khi bật một tích hợp 32 TỪ ĐIỂN Từ điển Việt Anh Các từ gặp trong sách 34 PHỤ LỤC A Mã nguồn, workflow và nhật ký Toàn bộ file đã chạy thử 35 PHỤ LỤC B Nguồn video và tài liệu Kênh, người trình bày, lượt xem, ngày đăng 44 PHỤ LỤC C Những điểm chưa xác minh Đọc trước khi trích dẫn 46 KẾT NỐI Học tiếp cùng Minh Đỗ Facebook, YouTube, nhóm Zalo 47 API LÀ GÌ?, TẬP 3 MỤC LỤC 3
MỞ ĐẦU Đọc sách này thế nào Tập 3 đưa API vào quy trình: dữ liệu tự chảy vào bảng tính, sự kiện tự tạo bản nháp, và mọi thứ có người trông. Bạn có thể tới đây từ Tập 1 nếu muốn dùng công cụ không code như n8n, hoặc từ Tập 2 nếu đã quen Python. Chương 1 và Chương 4 có ít code để đọc; Chương 2 và 3 có hai đường: một đường cho người dùng công cụ giao diện, một đường có code. Đã chạy thật và chưa chạy Đã chạy trên máy Linux của tác giả ngày 10/11/2026, mọi thứ chỉ nghe trên 127.0.0.1: một điểm nhận webhook Python có kiểm chữ ký, chống phát lại, chống trùng, xử lý sai thứ tự (8 kiểm thử tự động và 10 tình huống); một script đồng bộ chi phí từ máy chủ giả vào file CSV đóng vai bảng tính; n8n 2.47.3 cài bằng npm, chạy hai workflow (lấy chi phí nhiều trang, nhận webhook có khóa header). Chưa chạy: chưa chạm Google Sheets thật (mẫu Apps Script chỉ kiểm cú pháp bằng Node), chưa dùng Make hay Zapier, chưa có tài khoản n8n Cloud, chưa đưa điểm nhận nào ra Internet. Phần này lấy từ tài liệu chính thức đọc ngày 10/11/2026. Cách dùng mã QR Mã QR mở video ở giây bắt đầu; "xem từ ... đến ..." là điểm dừng. Mốc lấy từ chapter công khai, chưa đối chiếu phụ đề có giờ. Video n8n trong tập này quay năm 2024: dùng để hiểu khái niệm, giao diện hiện tại đã khác. API LÀ GÌ?, TẬP 3 MỞ ĐẦU 4
CHƯƠNG 1 Webhook là gì: khi hệ thống gọi lại cho bạn Thay vì năm phút một lần chạy ra hỏi "có đơn mới chưa", bạn để lại số điện thoại để hệ thống gọi khi có đơn. Nhưng ai cũng có thể gọi số đó. Học xong chương này, bạn sẽ Chọn giữa hỏi định kỳ (polling) và webhook. Kể được các phần của một webhook: sự kiện, id, payload, chữ ký. Biết webhook có thể tới trùng, tới muộn, sai thứ tự. Dựng điểm nhận kiểm chữ ký trên body thô và chống xử lý trùng. Chuông cửa và chạy ra kiểm Hỏi định kỳ (polling): bạn gọi API mỗi vài phút để xem có gì mới. Đơn giản, nhưng tốn lượt gọi và luôn trễ. Webhook: hệ thống nguồn gọi tới một địa chỉ của bạn khi có sự kiện, bằng một request HTTP (thường là POST) mang dữ liệu sự kiện. Webhook không thay API: thường bạn vẫn dùng API để đọc chi tiết hoặc đối soát. Video V09: xem từ 13:20 đến 15:29 n8n Beginner Course (2/9) · Introduction to APIs and Webhooks. Kênh n8n, người trình bày: đội ngũ n8n. Đoạn này: giải thích webhook bằng ví dụ chuông cửa so với chạy ra kiểm cửa, ví dụ thanh toán. Sửa video: video nói webhook được gửi đồng bộ. Không có bảo đảm chung nào như vậy; nhà cung cấp có thể gửi chậm, gửi lại, gửi trùng, gửi sai thứ tự (D34). Video năm 2024. https://youtu.be/y_cpFMF1pzk?t=800 Một sự kiện gồm gì Phần Ví dụ trong lab Dùng để Địa chỉ nhận POST /webhook/don-hang Nơi bên gửi gọi tới API LÀ GÌ?, TẬP 3 CHƯƠNG 1 5
Phần Ví dụ trong lab Dùng để Loại sự kiện don_hang.tao_moi Chỉ nhận loại đã đăng ký Id sự kiện evt_001 Chống xử lý trùng Dữ liệu (payload) mã đơn, khách, tổng, phiên bản Việc cần làm Chữ ký và thời điểm header X-Chu-Ky: t=...,v1 =... Chứng minh đúng bên gửi, chống phát lại Phản hồi của bạn 202 "đã lưu, sẽ xử lý" Báo bên gửi đừng gửi lại Bốn điều không được giả định Không đúng một lần: bên gửi gửi lại khi không nhận được 2xx kịp, nên cùng sự kiện có thể tới hai lần (D34). Không đúng thứ tự: bản cập nhật sau có thể tới trước (D34). Không tức thì: có thể trễ vài giây tới nhiều giờ khi bên gửi thử lại. Địa chỉ khó đoán không phải là bảo mật: URL có thể lộ qua nhật ký, ảnh chụp. Phải có chữ ký hoặc khóa. Một số bài viết nói mã 302 cũng tính là đã nhận; Stripe coi mọi mã 3xx là gửi thất bại (D34). Hãy trả 2xx. Điểm nhận trong lab nhan_webhook.py kiểm theo thứ tự rẻ trước, đắt sau: 1. Kích thước: quá 32 KB thì 413, không đọc tiếp. 2. Chữ ký: HMAC-SHA256 tính trên byte thô của body ghép với thời điểm, so bằng hàm so sánh thời gian hằng. Sai thì 401. 3. Thời điểm ký: lệch quá 300 giây thì 401, chống kẻ gian chụp lại một request cũ rồi gửi lại. 4. JSON đúng khuôn, loại sự kiện đã đăng ký. 5. Chống trùng: ghi id sự kiện vào SQLite bằng INSERT OR IGNORE ; đã có thì trả 200 "đã nhận trước đó". 6. Lưu xong mới trả 202, rồi xử lý sau trong một luồng riêng. 2xx nghĩa là "đã nhận và lưu", chưa phải "việc đã xong". API LÀ GÌ?, TẬP 3 CHƯƠNG 1 6
Câu hỏi thường gặp về ấn phẩm
Webhook và tích hợp văn phòng. Nội dung được biên soạn theo hướng thực chiến bởi Minh Đỗ, tập trung vào quy trình từng bước và khung câu lệnh (Prompt) áp dụng ngay vào công việc.
Ấn phẩm gồm 47 trang (13 mục thực hành), bao gồm các phần chính: Trang tên sách; Đọc sách này thế nào; Chương 1. Webhook là gì: khi hệ thống gọi lại cho bạn; Chương 2. Kết nối API với Google Sheets đúng chiều và đúng quyền; Chương 3. Một quy trình qua n8n, Make hoặc Zapier; Chương 4. Dự án cuối: kiểm thử, bàn giao và dùng lâu dài.
Bạn đọc có thể bấm nút "Mở Trình Đọc Tương Tác & Đọc Thử" ngay trên trang để lật đọc miễn phí các trang mở đầu và nghe miễn phí Phần 1 Sách nói trên Cổng Tri Thức Minh Đỗ, hoặc sở hữu trọn bộ PDF gốc kèm Sách nói với mức phí 99.000đ (hoặc mở không giới hạn toàn bộ 85+ ấn phẩm với Gói Hội viên 1 Năm 890.000đ).
Bạn đọc muốn áp dụng AI và công cụ số thực tế vào công việc hàng ngày.
Ấn phẩm cùng tủ sách: Tủ 4 · AI Agent, Bot & Kỹ thuật


