GraphQL Mutation 설계하기

간단 소개

GraphQL Mutation 설계 시 이름 규칙, Input/Payload 설계, 명시적인 Mutation 사용의 중요성을 강조합니다.

AI Summary

Mutation 이름 규칙
- Mutation 이름은 동사를 먼저 사용하고, 목적어나 명사를 뒤에 붙여 명확성을 높입니다.
- 예시: createUser, likePost
- 예외적으로, 데이터 모델이 CRUD 위주인 경우 객체 이름을 먼저 사용할 수 있습니다.
Input 및 Payload 설계
- Mutation은 단일하고 필수적인 input 객체를 사용해야 합니다.
- Input 객체는 중첩 구조를 활용하여 API 확장성을 확보합니다.
- 각 Mutation에 맞는 고유한 payload 타입을 정의하고, 결과 값을 필드로 추가합니다.
- 단일 값 반환 시에도 custom object 타입을 사용하여 유연성을 확보합니다.
명시적인 Mutation의 중요성
- 범용적인 Mutation 대신 UI가 만들 수 있는 업데이트와 일치하는 명시적인 Mutation을 사용합니다.
- 명시적인 Mutation은 UI 개발, 백엔드 최적화, 보안 측면에서 유리합니다.