Cad is geata API agus cén fáth a úsáidtear é?

Question

Accepted Answer

Is **geata API** a thugtar ar phointe iontrála amháin a bhíonn os comhair do mhicreasheirbhísí. Glaonann cliaint ar an ngeata, a threorann iarratais chuig an tseirbhís cheart agus a bhainistríonn imní thrasghearrthach.

## Cad a dhéanann sé

- **Foluain** — `/orders/*` a chur ar aghaidh chuig seirbhís na n-orduithe.
- **Fíordheimhniú** — tokens a fhíorú faoi bhrat amháin ag an imeall.
- **Teorannú an ráta** — seirbhísí cúil a dhíon ó dhrochuachtar.
- **Comhiomlánú** — glaonna iolrach seirbhíse a chur in aon fhreagra amháin.
- **Deireadh TLS, logáil, taisce.**

```text
            ┌─────────────────────────────┐
  Clients ─▶│        API Gateway          │
            │  auth · rate-limit · route  │
            └──┬──────────┬──────────┬────┘
               ▼          ▼          ▼
           Orders     Payments    Users
```

## Sampla cumrainn

```yaml
# gateway routes
routes:
  - path: /orders/**
    service: orders-service   # forward order traffic here
    rateLimit: 100/min        # throttle abusive clients
  - path: /users/**
    service: users-service
    auth: required            # gateway enforces auth before routing
```

## Práinn

Féadfaidh an geata a bheith ina **phointe cliseanna amháin** agus ina bhacainneach. Rith sé ar fáil an-ard agus coinnigh loighic gheilleagair amach as.

## Cén fáth a bhíonn tábhacht ann

Saorfann geata gach seirbhís ó athoibreoir fíordheimhniú, teorannú ráta agus TLS, agus tugann sé do chliaint URL seasmhach amháin in ionad na ndosaer.

Gan é, ní mór do chliaint seoladh gach seirbhíse a bheith ar eolas acu agus loighic thrasghearrthach a dhúblíonn, rud a éiríonn róchlasta go tapa.