GraphQL schema design માટે best practices શું છે?

Question

IT Interview Practice · Accepted Answer

સારો schema **client-driven, edges પર by-default nullable, અને versions વગર evolvable** હોય છે. તે domain ને એવા શબ્દોમાં model કરે છે જે clients ખરેખર વાપરે છે, તમારા database tables માં નહીં.

## Nullability

કોઈ field ને non-null (`!`) ત્યારે જ બનાવો જ્યારે તમે તેને *હંમેશા* પરત કરી શકો. `!` નો વધુ પડતો ઉપયોગ એક જાળ છે: જો non-null field error કરે, તો તે તેના આખા parent object ને null કરે છે, જેનાથી નાની failure મોટી ખાલી જગ્યામાં ફેરવાય છે. downstream service પર આધાર રાખતી કોઈ પણ વસ્તુ માટે nullable ને પ્રાધાન્ય આપો.

```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 & inputs

- સુસંગત, વર્ણનાત્મક names વાપરો; booleans predicates તરીકે વંચાય (`isPublished`).
- દરેક mutation ને એક જ **`input`** type આપો અને એક **payload** type પરત કરો — તમે પાછળથી signature તોડ્યા વગર fields ઉમેરી શકો છો.

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

## Versioning વગર evolution

GraphQL `/v2` URLs ટાળે છે. તમે **additively** evolve કરો છો: fields મુક્તપણે ઉમેરો, અને જૂનાને `@deprecated` વડે નિવૃત્ત કરો જ્યારે clients migrate થાય.

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

Field ને દૂર કરવું કે rename કરવું એ એકમાત્ર સાચો breaking change છે, તેથી એવી રીતે design કરો કે તમને ભાગ્યે જ તેની જરૂર પડે. DB આકાર leak કરવાનું પણ ટાળો (જો clients ને એક field જોઈતું હોય તો `first_name`/`last_name` નહીં પણ `fullName` ખુલ્લું કરો).

## આ શા માટે મહત્વનું છે

આ પસંદગીઓ જ વર્ષો સુધી ટકતા schema ને એવા schema થી અલગ પાડે છે જેની સામે clients લડે છે. Interviewers આનો ઉપયોગ **API design પરિપક્વતા** માપવા કરે છે — ખાસ કરીને nullability/error trade-off અને additive-evolution mindset, જે GraphQL ને અનન્ય છે.

Nullability

Naming & inputs

Versioning વગર evolution

આ શા માટે મહત્વનું છે

સંબંધિત પ્રશ્નો