Ugrás a tartalomra
Egyszeri díj11 ó · 61 lecke

Node.js & REST APIs

Az útvonal

  1. Előbb az erőforrásokat és a hibákat tervezd meg

    URL-ek, státuszkódok és hibaformák, még az első handler megírása előtt eldöntve.

    Itt szállsz fel
    110 perc
  2. A kérés útja

    Routing, middleware és validáció, és hogy melyik feladat hová tartozik.

    110 perc
  3. Adat, migrációk és tranzakciók

    Sémaváltozások, amiket pénteken is lefuttathatsz, és az a tranzakcióhatár, ami megment.

    110 perc
  4. Beléptetés kézlegyintés nélkül

    Session vagy token, hashelés, és azok a részek, amiket soha ne találj ki magad.

    110 perc
  5. Amikor hajnali kettőkor elromlik

    Strukturált logok, metrikák, timeoutok, újrapróbálkozás és idempotencia.

    110 perc
  6. Élesítés, és az utána következő első hét

    Konfiguráció, health checkek, és hogy mit érdemes valóban figyelni.

    110 perc

Bepillantás a tanításba

1. megálló · Előbb az erőforrásokat és a hibákat tervezd megMintarészlet

Döntsd el a hiba formáját, még az első handler előtt.

// One shape for every failure, so a client needs one code path.
type ApiError = {
  error: { code: string; message: string; field?: string };
};

// 409, not 400: the request was valid, the world disagreed.
if (await orders.exists(courseId, userId)) {
  return json<ApiError>(
    { error: { code: "already_owned", message: "You already own this course." } },
    { status: 409 },
  );
}

A státuszt abból válaszd, ami valóban történt, ne megszokásból. A 400 azt jelenti, hogy értelmetlent küldtél; a 409 azt, hogy értelmes dolgot küldtél, ami ütközik a valósággal.

Ki vezet

DM
Dávid Marton
Platform engineer, ex-fintech

Dávid úgy magyaráz, ahogy egy jó kolléga a tábla előtt — nincs öncélú szakzsargon, és nincs semmi elrejtve az „ahogy látható” mögé.

Helykitöltő profil