Mọi lộ trình

Thiết kế API cho thiết bị

Thiết kế một HTTP API cho một chiếc đèn trên ESP32-C3: tài nguyên, phương thức, lược đồ JSON, lỗi, token và phiên bản, kết thúc với tài liệu và một bài test hợp đồng.

ESP32-C3-DevKitM-1Miễn phí7 bài học6 h4 chương2.385 XPLập trình · Nâng cao+250 XP

Đã hoàn thành 0 trên 7

Bạn sẽ làm được gì

3 dự án, làm từng bước một

7 bài học trong 4 chương, khoảng 6 tiếng trên bo mạch ESP32-C3-DevKitM-1 được mô phỏng. Miễn phí, ngay trong trình duyệt, mọi bước đều được trình mô phỏng kiểm tra.

Dự án chương 1

Phương thức

GET, PUT, PATCH, POST và DELETE trên một đèn và một bộ lịch trình: 201 kèm Location, 204 khi xóa, 405 kèm header Allow, và phương thức nào an toàn để lặp lại.

Mở trong trình mô phỏng
Dự án chương 2

Lỗi

400, 409, 422 và 503 từ một API đèn, một Retry-After cho biết khi nào thử lại, và một dạng lỗi chung cho tất cả, kể cả lỗi 404 bị bỏ quên.

Mở trong trình mô phỏng
Dự án chương 3

Đánh số phiên bản

Hai phiên bản API đèn trên cùng một đèn: đổi tên phá tính tương thích thì lấy /v2, phiên bản cũ vẫn chạy với ngày Sunset, còn một trường thêm vào thì chẳng cần phiên bản mới.

Mở trong trình mô phỏng
Bản đồ

Từng chương một

Mỗi bài học mở ra khi bài trước hoàn thành, và mỗi chương kết thúc bằng một dự án.

Chương 1

Hình dạng của một API

Đặt tên cho tài nguyên bằng đường dẫn và nói rõ việc cần làm bằng phương thức.

  1. Mở227 XP

    Tài nguyên và tuyến

    Một chiếc đèn với HTTP API: bảng định tuyến, console gửi yêu cầu thật, dùng danh từ thay cho động từ, và vì sao một GET bật đèn là một lỗi.

    0/5 bước

  2. Dự ánĐã khóa500 XP

    Phương thức

    GET, PUT, PATCH, POST và DELETE trên một đèn và một bộ lịch trình: 201 kèm Location, 204 khi xóa, 405 kèm header Allow, và phương thức nào an toàn để lặp lại.

    0/5 bước

4 câu hỏi, được chấm ngay khi bạn trả lời.
Chương 2

Hợp đồng và lỗi

Ghi lại hợp đồng của phần thân, kiểm tra nó, và trả lỗi theo một dạng duy nhất, rõ ràng.

  1. Đã khóa250 XP

    JSON schema

    Hợp đồng của chiếc đèn viết bằng JSON Schema, một PUT kiểm tra từng trường theo cùng quy tắc và trả về 422 kèm từng lỗi, cũng như xử lý một trường không hề yêu cầu thế nào.

    0/5 bước

  2. Dự ánĐã khóa454 XP

    Lỗi

    400, 409, 422 và 503 từ một API đèn, một Retry-After cho biết khi nào thử lại, và một dạng lỗi chung cho tất cả, kể cả lỗi 404 bị bỏ quên.

    0/5 bước

4 câu hỏi, được chấm ngay khi bạn trả lời.
Chương 3

Tin tưởng và thay đổi

Quyết định ai được làm gì, và thay đổi API mà không làm hỏng client.

  1. Đã khóa227 XP

    Token xác thực

    Bearer token trên API của đèn: 401 khi thiếu token, 403 khi sai token, một bước kiểm tra trong router mà không handler nào bỏ qua được, token không ghi vào log, và vì sao token nằm trong firmware không phải là bí mật.

    0/5 bước

  2. Dự ánĐã khóa500 XP

    Đánh số phiên bản

    Hai phiên bản API đèn trên cùng một đèn: đổi tên phá tính tương thích thì lấy /v2, phiên bản cũ vẫn chạy với ngày Sunset, còn một trường thêm vào thì chẳng cần phiên bản mới.

    0/5 bước

4 câu hỏi, được chấm ngay khi bạn trả lời.
Chương 4

Boss: API đèn có tài liệu

Ra mắt phiên bản 1 với tài liệu tự sinh, một bài kiểm tra hợp đồng và một hướng dẫn.

  1. Đã khóa227 XP

    Boss: API đèn có tài liệu

    Toàn bộ API của đèn, phiên bản 1: tuyến, phương thức, schema được kiểm tra, một dạng lỗi duy nhất và token, kèm tài liệu sinh từ bảng định tuyến và bộ kiểm tra hợp đồng gọi tới mọi tuyến.

    0/5 bước

3 câu hỏi, được chấm điểm ngay khi bạn làm.
Chứng chỉ

Chứng chỉ khi bạn hoàn thành

Hoàn thành mọi bài học và vượt qua mọi bài kiểm tra cuối chương, Mokxi sẽ cấp chứng chỉ ghi tên bạn, được xác minh trên trang riêng của nó.

Số chứng chỉ:MXC0-URSE-0001

Chứng chỉ Hoàn thành

Chứng nhận rằng

Tên Của Bạn

đã hoàn thành tốt khóa học

Thiết kế API cho thiết bị

Bao gồm hình dạng của một API, Hợp đồng và lỗi, Tin tưởng và thay đổi, và Boss: API đèn có tài liệu.

7 bài học · khoảng 6 giờ học

DaneDane, Nhà sáng lập, MokxiCấp ngày 17 tháng 11, 2026
Xác minh chứng chỉ nàymokxi.com/cert/MXC0URSE0001
Chứng chỉ

Nhận chứng chỉ của bạn

  • Tên bạn và một mã số duy nhấtIn trên chứng chỉ khổ ngang thuộc về bạn.
  • Được Mokxi xác minhMã QR và trang công khai để ai cũng có thể kiểm tra.
  • Thêm vào LinkedInMột cú nhấp điền sẵn biểu mẫu chứng chỉ trên LinkedIn.
  • Tải về PDFIn ra hoặc đính kèm vào CV hay hồ sơ xin việc.

Hoàn thành khóa học để nhận chứng chỉ có thể xác minh, ghi tên bạn, kèm mã QR và liên kết cho LinkedIn. Chứng chỉ đi kèm gói Pro, và 7 ngày dùng thử miễn phí.

Nội dung khóa học

Mọi bài học trong khóa

Tất cả 7 bài học, theo thứ tự, kèm nội dung mỗi bài. Bất kỳ bài nào cũng mở ngay trong trình soạn code.

Chương 1

Hình dạng của một API

  1. Tài nguyên và tuyếnMột chiếc đèn với HTTP API: bảng định tuyến, console gửi yêu cầu thật, dùng danh từ thay cho động từ, và vì sao một GET bật đèn là một lỗi.
  2. Phương thứcGET, PUT, PATCH, POST và DELETE trên một đèn và một bộ lịch trình: 201 kèm Location, 204 khi xóa, 405 kèm header Allow, và phương thức nào an toàn để lặp lại.
Chương 2

Hợp đồng và lỗi

  1. JSON schemaHợp đồng của chiếc đèn viết bằng JSON Schema, một PUT kiểm tra từng trường theo cùng quy tắc và trả về 422 kèm từng lỗi, cũng như xử lý một trường không hề yêu cầu thế nào.
  2. Lỗi400, 409, 422 và 503 từ một API đèn, một Retry-After cho biết khi nào thử lại, và một dạng lỗi chung cho tất cả, kể cả lỗi 404 bị bỏ quên.
Chương 3

Tin tưởng và thay đổi

  1. Token xác thựcBearer token trên API của đèn: 401 khi thiếu token, 403 khi sai token, một bước kiểm tra trong router mà không handler nào bỏ qua được, token không ghi vào log, và vì sao token nằm trong firmware không phải là bí mật.
  2. Đánh số phiên bảnHai phiên bản API đèn trên cùng một đèn: đổi tên phá tính tương thích thì lấy /v2, phiên bản cũ vẫn chạy với ngày Sunset, còn một trường thêm vào thì chẳng cần phiên bản mới.
Chương 4

Boss: API đèn có tài liệu

  1. Boss: API đèn có tài liệuToàn bộ API của đèn, phiên bản 1: tuyến, phương thức, schema được kiểm tra, một dạng lỗi duy nhất và token, kèm tài liệu sinh từ bảng định tuyến và bộ kiểm tra hợp đồng gọi tới mọi tuyến.
Bộ kit

Cùng lắp trên bàn thực hành của bạn

Mỗi bài học đều chạy trong trình mô phỏng, không cần mua gì. Khi bạn muốn làm thật, các bộ kit này có sẵn linh kiện.

Đã có kit rồi?

Tìm kit của bạn

Chọn bộ kit khởi đầu bạn đang có và chạy mọi bài học trong sách hướng dẫn với cùng linh kiện trên cùng các chân.

Xem tất cả các kit
Câu hỏi

Về khóa Thiết kế API cho thiết bị

Khóa Thiết kế API cho thiết bị có miễn phí không?

Có. Cả 7 bài học của Thiết kế API cho thiết bị đều miễn phí và chạy ngay trong trình duyệt, không cần cài đặt gì và không phải mua linh kiện trước khi bắt đầu.

Tôi có cần một bo mạch ESP32-C3-DevKitM-1 thật không?

Không. Mỗi bài học chạy trên ESP32-C3-DevKitM-1 được mô phỏng với linh kiện trên khung vẽ, và trình mô phỏng kiểm tra từng bước khi bạn thực hiện. Khi bạn muốn làm thật, cách nối dây và code giống hệt chạy trên bo mạch thật.

Khóa Thiết kế API cho thiết bị mất bao lâu?

Khoảng 6 giờ: 7 bài học trong 4 chương, mỗi bài gồm vài bước ngắn. Tiến độ của bạn được lưu lại, nên bạn có thể dừng ở bất kỳ bài học nào và tiếp tục từ chỗ đã dừng.

Mình sẽ làm được gì?

Mỗi chương kết thúc bằng một dự án tổng hợp: Phương thức, Lỗi và Phiên bản.

Bắt đầu từ đâu?

Bắt đầu với "Tài nguyên và tuyến", và mỗi bài học xây dựng trên bài trước đó. Mới học mạch điện tử? Điện tử cơ bản là khóa học bắt đầu từ con số không.