X'inhuma l-aħjar prattiċi għad-disinn ta' schema GraphQL?

Question

IT Interview Practice · Accepted Answer

Schema tajba hija **immexxija mill-klijent, nullable-by-default fit-truf, u tista' tevolvi mingħajr versjonijiet**. Timmodella d-dominju f'termini li l-klijenti tabilħaqq jużaw, mhux it-tabelli tad-database tiegħek.

## Nullability

Agħmel field non-null (`!`) biss meta tista' *dejjem* tirritornah. Li tuża `!` iżżejjed hija nassa: jekk field non-null ikollu error, jagħmel null l-object parent kollu tiegħu, u jibdel falliment żgħir f'vojt kbir. Ippreferi nullable għal kull ħaġa li tiddependi fuq servizz downstream.

```graphql
type User {
  id: ID!             # truly always present
  email: String!      # required in your DB -> safe as non-null
  avatarUrl: String   # comes from an external service -> nullable, so its failure is isolated
}
```

## Naming u inputs

- Uża ismijiet konsistenti u deskrittivi; il-booleans jinqraw bħala predikati (`isPublished`).
- Agħti lil kull mutation tip **`input`** wieħed u rritorna tip **payload** — tista' żżid fields aktar tard mingħajr ma tikser is-signature.

```graphql
input CreatePostInput { title: String!, body: String! }
type CreatePostPayload { post: Post!, errors: [UserError!]! }  # room to grow
type Mutation { createPost(input: CreatePostInput!): CreatePostPayload! }
```

## Evoluzzjoni mingħajr versjonar

GraphQL jevita URLs `/v2`. Tevolvi **b'mod additiv**: żid fields liberament, u rtira dawk qodma b'`@deprecated` waqt li l-klijenti jimmigraw.

```graphql
type User {
  fullName: String!
  name: String! @deprecated(reason: "Use fullName")   # keep serving until clients move off
}
```

Li tneħħi jew tbiddel l-isem ta' field huwa l-uniku breaking change veru, allura fassal b'mod li rarament ikollok bżonn. Evita wkoll li tikxef il-forma tad-DB (esponi `fullName`, mhux `first_name`/`last_name` jekk il-klijenti jridu field wieħed).

## Għaliex huwa importanti

Dawn l-għażliet huma dak li jiddistingwi schema li ddum snin minn waħda li l-klijenti jissieltu magħha. L-intervistaturi jużaw dan biex ikejlu l-**maturità fid-disinn tal-API** — speċjalment it-trade-off tan-nullability/errors u l-mentalità tal-evoluzzjoni additiva, li huma uniċi għal GraphQL.

Nullability

Naming u inputs

Evoluzzjoni mingħajr versjonar

Għaliex huwa importanti

Mistoqsijiet relatati