The Design of Web APIs – 2nd Edition của Arnaud Lauret giúp bạn thiết kế API đáp ứng đúng nhu cầu, dễ tích hợp và dễ phát triển về sau. Bộ sách dành cho Backend Developer, API Developer, Tech Lead và những người tham gia thiết kế hoặc sử dụng API.
Giá trị nổi bật là cách nối yêu cầu nghiệp vụ với quyết định kỹ thuật: API cần có năng lực gì, biểu diễn qua REST/HTTP ra sao và mô tả bằng OpenAPI, JSON Schema thế nào để các bên cùng hiểu đúng. Các phần về bảo mật, hiệu quả, tương thích ngược và quy chuẩn giúp người đọc cân nhắc thiết kế trước khi triển khai.
Bộ sách gồm 2 tập, 911 trang ruột (Tập 1: 524 trang, Tập 2: 387 trang), gồm 19 chương trong 4 phần. Mỗi tập có phần đáp án tương ứng với nội dung đã học.
Sách không dừng ở lý thuyết REST chung chung mà đi vào từng quyết định thiết kế cụ thể, kèm ví dụ tình huống để người đọc đối chiếu ngay với API mình đang phụ trách:
Chương 1 mở đầu bằng góc nhìn tổng quan về Web API và tiến trình thiết kế sẽ được khai triển xuyên suốt sách. Phần 1 (chương 2–7) xây dựng nguyên lý nền tảng: xác định năng lực API (API capabilities) đáp ứng đúng nhu cầu, quan sát năng lực dưới góc nhìn REST để tách tài nguyên và thao tác, biểu diễn thao tác qua HTTP (đường dẫn, HTTP method, status code, vị trí dữ liệu trong yêu cầu và phản hồi), mô hình hóa dữ liệu gồm tài nguyên, path parameter, query parameter, header và body, rồi mô tả toàn bộ bằng OpenAPI và JSON Schema.
Phần 2 (chương 8–11) chuyển sang thiết kế API thân thiện và đạt khả năng tương tác (interoperability) tốt ở bốn cấp độ: dữ liệu (chọn, định nghĩa, xác định kiểu, tổ chức và đặt tên dữ liệu), thao tác (rõ ràng, dễ đoán, hỗ trợ phân trang, lọc, sắp xếp, xử lý lỗi minh bạch), chuỗi thao tác (giảm lỗi, tăng linh hoạt) và API tổng thể (chia tách hay gộp API, đặt tên, điều hướng bằng HTTP và hypermedia). Các chương 2–11 có bài tập; đáp án được đặt ở cuối Tập 1 để người đọc tự làm trước khi đối chiếu.
Phần 3 (chương 12–15) phân tích những ràng buộc mà bảo mật, hiệu năng, dữ liệu, kiến trúc và yêu cầu thay đổi đặt lên thiết kế API lý tưởng. Chương 12 bàn về mức độ nhạy cảm của dữ liệu, hành vi thao tác an toàn, toàn vẹn dữ liệu và kiểm soát truy cập bằng scope. Chương 13 tối ưu dung lượng dữ liệu, bộ nhớ đệm (cache), xử lý nhiều phần tử đồng thời. Chương 14 xử lý tệp, tác vụ kéo dài (long-running operation), webhook và điểm khác biệt so với các kiểu API ngoài REST. Chương 15 hướng dẫn sửa đổi API mà không làm gián đoạn ứng dụng đang dùng, cùng chiến lược versioning.
Phần 4 (chương 16–19) hướng đến việc duy trì chất lượng thiết kế ở quy mô nhóm và lâu dài: chương 16 xây dựng bộ hướng dẫn thiết kế API và cách ra quyết định tự tin, chương 17 tối ưu tài liệu OpenAPI bằng tái sử dụng lược đồ (schema), tham số và phản hồi dùng chung, chương 18 tự động hóa quy chuẩn bằng Spectral – công cụ kiểm tra đặc tả và quy chuẩn thiết kế API (API linter), và chương 19 hoàn thiện bộ đầu ra thiết kế API (API design artifacts) thành một bộ tài liệu tham khảo phục vụ toàn vòng đời API. Đáp án chương 12–19 được đặt ở cuối Tập 2; đáp án chương 2–11 nằm ở cuối Tập 1.
Bộ sách kèm Code Companion PDF 98 trang, tải qua mã QR trong sách, tổng hợp 171 mục ví dụ mã, cấu hình YAML/JSON, đoạn OpenAPI và Spectral rule xuất hiện trong sách – đây là 171 mục tra cứu, không phải 171 ứng dụng chạy độc lập. Companion dùng chung cho cả hai tập, có bảng tra cứu theo tập, chương/mục và số trang. PDF còn đính kèm tệp ZIP mã nguồn chính thức để người đọc mở và đối chiếu với các ví dụ. Một số khối mã trong Companion phụ thuộc vào bước trước đó, dữ liệu hoặc phiên bản thư viện cụ thể (ví dụ Node.js và Spectral CLI phiên bản 6 để chạy các quy tắc ở chương 18); phần trích đoạn minh họa chữ ký API hoặc skeleton được giữ nguyên như bản gốc và không được xem là đoạn mã chạy độc lập. Đây là quà tặng khác biệt với eBook tiếng Anh (bản gốc) cũng được tặng kèm khi mua bộ sách – hai tệp phục vụ hai mục đích riêng, không thay thế cho nhau.
Sách hướng đến người đã từng xây dựng hoặc sử dụng API: Backend Developer, API Developer, Software Engineer đang trực tiếp thiết kế endpoint; Tech Lead và API Architect quản lý nhiều API cùng lúc; Business Analyst, QA và technical writer tham gia vào công đoạn đặc tả hoặc kiểm thử thiết kế API. Sách giả định người đọc đã quen với khái niệm HTTP, request/response cơ bản; đây không phải tài liệu nhập môn lập trình web hay hướng dẫn viết code backend cho một ngôn ngữ cụ thể. Nếu bạn cần một sách dạy triển khai server, xử lý hạ tầng vận hành hoặc quy trình kiểm thử tự động end-to-end, bạn sẽ cần thêm tài liệu chuyên về những chủ đề đó.
Giá trị chính của bộ sách nằm ở việc trình bày thiết kế API như một quy trình có thể lặp lại: xác định năng lực, thiết kế giao diện lập trình, mô tả bằng OpenAPI/JSON Schema, rồi làm giàu bằng quy chuẩn và tài liệu tham khảo. Cách tiếp cận này giúp giảm tranh cãi chủ quan trong review thiết kế, vì người thiết kế có cơ sở giải thích lựa chọn theo nhu cầu, ràng buộc và các tiêu chí chung. Nội dung nên được đọc tuần tự từ chương 1 đến chương 7 vì các chương sau xây dựng trực tiếp trên nền kiến thức này; sau mốc đó, người đọc có thể chọn chương theo vấn đề đang gặp phải, ví dụ đọc thẳng chương 15 khi cần versioning gấp, hoặc chương 18 khi muốn tự động hóa quy chuẩn bằng Spectral.
Sách có dạy viết code triển khai API không? Không. Đây là sách thiết kế: xác định năng lực, mô hình REST/HTTP, mô tả bằng OpenAPI/JSON Schema, không đi vào code backend, hạ tầng vận hành hay kiểm thử end-to-end.
Người mới học lập trình đọc có phù hợp không? Sách phù hợp hơn với người đã từng xây dựng hoặc sử dụng API và quen thuộc HTTP cơ bản, vì các chương sau xây dựng trên nền kiến thức REST/HTTP đã học ở chương đầu.
171 mục trong Code Companion có phải 171 chương trình chạy độc lập? Không. Đó là 171 mục ví dụ mã, cấu hình và trích đoạn OpenAPI/JSON Schema/Spectral để tra cứu theo tập-chương-trang; một số khối phụ thuộc bước trước hoặc dữ liệu/thư viện cụ thể.
eBook tiếng Anh và Companion PDF có phải cùng một tệp? Không. eBook tiếng Anh là bản gốc để đối chiếu thuật ngữ; Companion PDF là tài liệu tra cứu mã nguồn riêng đi kèm bản in – đây là hai quà tặng khác nhau.
Bộ sách dày bao nhiêu, đóng gói thế nào? Bộ sách gồm 911 trang ruột: Tập 1 có 524 trang, Tập 2 có 387 trang. Hai cuốn có bìa mềm full màu, ruột in đen trắng.
Chính sách bảo hành khi sách bị lỗi in ra sao? 89ebook áp dụng chính sách lỗi in 1 đổi 1 trong 90 ngày kể từ ngày nhận sách nếu phát hiện lỗi in.
Tên đầy đủ: The Design of Web APIs – 2nd Edition – Thiết Kế API Dễ Dùng, Bảo Mật Và Dễ Mở Rộng – Bản Tiếng Việt Expert Version 2026 – Tập 1 + 2
