Kako se komponente v sistemu sporazumevajo (API-ji)?

Question

Accepted Answer

V sistemu se komponente (storitve, odjemalci) sporazumevajo prek **API-jev** in različnih protokolov — sinhronih (REST, gRPC) in asinhronih (sporočila/vrste). Razumevanje, kako se komponente sporazumevajo, je temeljno za načrtovanje sistemov, ki so sestavljeni iz več delov.

## Sinhrona komunikacija (zahtevek/odgovor)

```text
The caller WAITS for a response (blocking):
  REST (HTTP) → most common; resources over HTTP (JSON) → simple, ubiquitous, web-friendly
  gRPC → high-performance RPC (binary, HTTP/2) → fast, typed; good for internal services
  GraphQL → flexible queries (client requests exactly what it needs)
→ for: direct request/response where the caller needs an answer now
```

## Asinhrona komunikacija (sporočila)

```text
The caller does NOT wait (decoupled, non-blocking):
  MESSAGE QUEUES (RabbitMQ, SQS) → send a message; a consumer processes it later
  EVENT STREAMING (Kafka) → publish events; consumers react
  PUB/SUB → broadcast events to subscribers
→ for: decoupling, background work, handling spikes, event-driven systems
  ✓ resilience (queue buffers), scalability, decoupling  ✗ more complexity, eventual consistency
```

## Izbira in razmisleki

```text
SYNC → when the caller needs an immediate response; simpler request/response
ASYNC → when decoupling, resilience, or background processing matters (don't block)
→ Also: API design (clear contracts), versioning, error handling, timeouts/retries,
  authentication, rate limiting → robust communication between components
```

## Zakaj je to pomembno

Razumevanje, kako se komponente sporazumevajo prek API-jev, je temeljno, ker so **sistemi sestavljeni iz več delov, ki se morajo sporazumevati**, zato je razumevanje komunikacije bistveno za njihovo načrtovanje.

Sistemi so sestavljeni iz storitev in odjemalcev, ki medsebojno delujejo, in način njihovega sporazumevanja je temeljni vidik načrtovanja sistema.

Razumevanje **sinhrona komunikacija** (zahtevek/odgovor, pri kateri klicalec čaka) — **REST** (vseprisotni pristop HTTP/JSON), **gRPC** (zmogljiv RPC za notranje storitve) in GraphQL (prožne poizvedbe) — pokriva pogosto uporabljene načine, kako komponente opravijo neposredne klice in pričakujejo odgovor.

Razumevanje **asinhrona komunikacija** (odceljena, neblokirajoča) — **vrste sporočil** (pošiljanje sporočil za kasnejšo obdelavo), **pretakanje dogodkov** (Kafka) in pub/sub — je enako pomembno, saj omogoča **odceljivost, odpornost (vrste, ki blažijo obremenitev), razširljivost in sisteme, ki jih vodijo dogodki**, na račun večje kompleksnosti in končne skladnosti.

Razumevanje **razlika med sinhron in asinhron ter kdaj uporabiti katerega** — sinhrono, kadar klicalec potrebuje takojšen odgovor, asinhron kadar je odceljivost, odpornost ali obdelava v ozadju pomembna — je ključen vidik načrtovanja, ki bistveno vpliva na lastnosti sistema.

Razumevanje dodatnih razmislekov (jasni API pogodbe, verzioniranje, obravnavanje napak, časovne omejitve/ponovni poskusi, avtentifikacija, omejitev hitrosti) odraža načrtovanje robustne komunikacije.

Ker so sistemi sestavljeni iz delov, ki se sporazumevajo, in ker način njihovega sporazumevanja (sinhron proti asinhron, protokoli in vidiki načrtovanja) bistveno oblikuje sistem, in ker je razumevanje komunikacije komponent bistveno za načrtovanje sistemov z več komponentami, je razumevanje, kako se komponente sporazumevajo prek API-jev, bistveno, temeljno znanje o načrtovanju sistemov — temeljno za načrtovanje sistemov, sestavljenih iz več delov, ki medsebojno delujejo, zajema sinhrono in asinhrono komunikacijo, ki povezuje komponente, in je osrednje pri gradnji razporejenih, storitorientiranih sistemov, pogostih v današnjem času.