Semua jalur

Rancang API perangkat

Rancang API HTTP untuk sebuah lampu di ESP32-C3: resource, method, skema JSON, error, token dan versi, diakhiri dengan dokumentasi dan contract test.

ESP32-C3-DevKitM-1Gratis7 pelajaran6 h4 bab2.385 XPCoding · Lanjutan+250 XP

0 dari 7 selesai

Apa yang akan kamu rakit

3 proyek, dibangun langkah demi langkah

7 pelajaran dalam 4 bab, sekitar 6 jam di ESP32-C3-DevKitM-1 simulasi. Gratis, di browser-mu, setiap langkah diperiksa oleh simulator.

Proyek bab 1

Method

GET, PUT, PATCH, POST, dan DELETE pada sebuah lampu dan kumpulan jadwal: 201 dengan Location, 204 saat delete, 405 dengan header Allow, dan method mana yang aman diulang.

Buka di simulator
Proyek Bab 2

Error

400, 409, 422, dan 503 dari API lampu, sebuah Retry-After yang memberi tahu kapan harus mencoba lagi, dan satu bentuk error untuk semuanya, termasuk 404 yang lupa disertakan.

Buka di simulator
Proyek bab 3

Versioning

Dua versi API lampu di atas satu lampu: penggantian nama yang breaking dapat /v2, versi lama tetap berjalan dengan tanggal Sunset, dan field tambahan tidak butuh versi baru sama sekali.

Buka di simulator
Peta

Bab demi bab

Setiap pelajaran terbuka setelah pelajaran sebelumnya selesai, dan setiap bab ditutup dengan sebuah proyek.

Bab 1

Bentuk sebuah API

Beri nama resource dengan path dan katakan apa yang harus dilakukan dengan method.

  1. Buka227 XP

    Resource dan route

    Lampu dengan HTTP API: tabel routing, konsol yang mengirim request sungguhan, kata benda alih-alih kata kerja, dan kenapa GET yang menyalakan lampu adalah bug.

    0 dari 5 langkah

  2. ProyekTerkunci500 XP

    Method

    GET, PUT, PATCH, POST, dan DELETE pada sebuah lampu dan kumpulan jadwal: 201 dengan Location, 204 saat delete, 405 dengan header Allow, dan method mana yang aman diulang.

    0 dari 5 langkah

4 pertanyaan, dinilai sambil mengerjakan.
Bab 2

Kontrak dan kegagalan

Tuliskan kontrak body, periksa, dan gagalkan dalam satu bentuk yang jelas.

  1. Terkunci250 XP

    Skema JSON

    Kontrak lampu ditulis sebagai JSON Schema, PUT yang memeriksa setiap field dengan aturan yang sama dan menjawab 422 dengan setiap masalahnya, serta apa yang dilakukan dengan field yang tidak pernah kamu minta.

    0 dari 5 langkah

  2. ProyekTerkunci454 XP

    Error

    400, 409, 422, dan 503 dari API lampu, sebuah Retry-After yang memberi tahu kapan harus mencoba lagi, dan satu bentuk error untuk semuanya, termasuk 404 yang lupa disertakan.

    0 dari 5 langkah

4 pertanyaan, dinilai sambil mengerjakan.
Bab 3

Kepercayaan dan perubahan

Tentukan siapa boleh melakukan apa, dan ubah API tanpa merusak client.

  1. Terkunci227 XP

    Token autentikasi

    Bearer token pada API lampu: 401 tanpa token, 403 dengan token yang salah, pemeriksaan di router yang tidak bisa dilewati handler mana pun, token yang dijauhkan dari log, dan kenapa token di firmware bukanlah rahasia.

    0 dari 5 langkah

  2. ProyekTerkunci500 XP

    Versioning

    Dua versi API lampu di atas satu lampu: penggantian nama yang breaking dapat /v2, versi lama tetap berjalan dengan tanggal Sunset, dan field tambahan tidak butuh versi baru sama sekali.

    0 dari 5 langkah

4 pertanyaan, dinilai sambil mengerjakan.
Bab 4

Boss: API lampu terdokumentasi

Rilis versi 1 dengan docs yang dibuat otomatis, contract test dan panduan.

  1. Terkunci227 XP

    Boss: API lampu terdokumentasi

    Seluruh API lampu, versi 1: route, method, skema yang diperiksa, satu bentuk error dan token, dengan docs yang dihasilkan dari tabel routing dan suite contract test yang memanggil setiap route.

    0 dari 5 langkah

3 pertanyaan, dinilai selagi mengerjakan.
Sertifikat

Sertifikat saat kamu menyelesaikan

Selesaikan semua pelajaran dan lulus semua kuis bab, lalu Mokxi menerbitkan sertifikat dengan namamu, terverifikasi di halamannya sendiri.

No. SertifikatMXC0-URSE-0001

Sertifikat Penyelesaian

Ini untuk menyatakan bahwa

Nama Kamu

telah berhasil menyelesaikan kursus

Rancang API perangkat

Mencakup bentuk sebuah API, Kontrak dan kegagalan, Kepercayaan dan perubahan, dan Boss: API lampu terdokumentasi.

7 pelajaran · sekitar 6 jam belajar

DaneDane, Pendiri, MokxiDiterbitkan 17 November 2026
Verifikasi sertifikat inimokxi.com/cert/MXC0URSE0001
Sertifikat

Raih sertifikatmu

  • Namamu dan ID unikDicetak pada sertifikat mode lanskap yang jadi milikmu.
  • Diverifikasi oleh MokxiKode QR dan halaman publik yang bisa dicek siapa pun.
  • Tambahkan ke LinkedInSatu klik mengisi formulir sertifikasi LinkedIn.
  • Unduh sebagai PDFCetak atau lampirkan ke CV atau lamaranmu.

Selesaikan kursusnya dan raih sertifikat terverifikasi atas namamu, lengkap dengan kode QR dan link untuk LinkedIn. Sertifikat tersedia di paket Pro, dan uji coba 7 hari gratis.

Silabus

Semua pelajaran dalam kursus

Semua 7 pelajaran, berurutan, masing-masing dengan cakupannya. Semuanya langsung terbuka di editor.

Bab 1

Bentuk sebuah API

  1. Resource dan routeLampu dengan HTTP API: tabel routing, konsol yang mengirim request sungguhan, kata benda alih-alih kata kerja, dan kenapa GET yang menyalakan lampu adalah bug.
  2. MethodGET, PUT, PATCH, POST, dan DELETE pada sebuah lampu dan kumpulan jadwal: 201 dengan Location, 204 saat delete, 405 dengan header Allow, dan method mana yang aman diulang.
Bab 2

Kontrak dan kegagalan

  1. Skema JSONKontrak lampu ditulis sebagai JSON Schema, PUT yang memeriksa setiap field dengan aturan yang sama dan menjawab 422 dengan setiap masalahnya, serta apa yang dilakukan dengan field yang tidak pernah kamu minta.
  2. Error400, 409, 422, dan 503 dari API lampu, sebuah Retry-After yang memberi tahu kapan harus mencoba lagi, dan satu bentuk error untuk semuanya, termasuk 404 yang lupa disertakan.
Bab 3

Kepercayaan dan perubahan

  1. Token autentikasiBearer token pada API lampu: 401 tanpa token, 403 dengan token yang salah, pemeriksaan di router yang tidak bisa dilewati handler mana pun, token yang dijauhkan dari log, dan kenapa token di firmware bukanlah rahasia.
  2. VersioningDua versi API lampu di atas satu lampu: penggantian nama yang breaking dapat /v2, versi lama tetap berjalan dengan tanggal Sunset, dan field tambahan tidak butuh versi baru sama sekali.
Bab 4

Boss: API lampu terdokumentasi

  1. Boss: API lampu terdokumentasiSeluruh API lampu, versi 1: route, method, skema yang diperiksa, satu bentuk error dan token, dengan docs yang dihasilkan dari tabel routing dan suite contract test yang memanggil setiap route.
Kit

Rangkai juga di meja kerja kamu

Setiap pelajaran jalan di simulator tanpa perlu membeli apa pun. Kalau kamu mau yang asli, kit berikut punya komponennya.

Sudah punya kit?

Cari kit kamu

Pilih starter kit yang kamu punya dan jalankan setiap pelajaran di manualnya dengan komponen yang sama di pin yang sama.

Lihat semua kit
Pertanyaan

Tentang Rancang API perangkat

Apakah Rancang API perangkat gratis?

Ya. Semua 7 pelajaran Rancang API perangkat gratis dan berjalan di browser kamu, tanpa perlu memasang apa pun dan tanpa komponen yang harus dibeli sebelum mulai.

Apakah kamu butuh ESP32-C3-DevKitM-1 sungguhan?

Tidak. Setiap pelajaran berjalan di ESP32-C3-DevKitM-1 simulasi dengan komponennya di kanvas, dan simulator memeriksa tiap langkahmu. Saat kamu ingin membuatnya sungguhan, kabel dan kode yang sama bekerja di board asli.

Berapa lama waktu yang dibutuhkan Rancang API perangkat?

Sekitar 6 jam: 7 pelajaran dalam 4 bab, masing-masing terdiri dari beberapa langkah singkat. Progresmu tersimpan, jadi kamu bisa berhenti setelah pelajaran mana pun dan melanjutkannya nanti.

Apa yang akan aku buat?

Setiap bab diakhiri dengan proyek yang merangkum semuanya: Method, Error dan Versioning.

Di mana aku mulai?

Dimulai dengan "Resource dan route", dan setiap pelajaran dibangun di atas pelajaran sebelumnya. Baru mengenal rangkaian? Dasar elektronika adalah kursus yang mulai dari nol.