GraphQL Mutation 설계하기

간단 소개

GraphQL mutation 설계 시 이름 규칙, input/payload 구조, 중첩 활용 전략을 통해 효과적인 API를 구축하는 방법을 제시합니다.

AI Summary

Mutation 이름 규칙
- Mutation 이름은 동사로 시작하고, 목적어나 명사를 뒤에 붙여 명확성을 높입니다. 예: createUser, likePost
- 일반적인 mutation보다 명시적인 mutation이 UI 개발, 백엔드 최적화, 보안 측면에서 유리합니다.
Input 및 Payload 설계
- Mutation은 단일 필수 input 객체를 사용해야 클라이언트 사용성이 향상됩니다.
- Input 객체는 중첩 구조를 활용하여 API 확장성을 확보하고, 버전 관리를 용이하게 합니다.
- 각 mutation에 맞는 고유한 payload 타입을 생성하여 반환값과 메타데이터를 유연하게 추가할 수 있도록 합니다.
종합적인 예시
- TodoMVC 애플리케이션의 GraphQL mutation 시스템 예시를 통해 권장 사항을 실제 코드에 적용하는 방법을 보여줍니다.
- CreateTodoInput, ToggleTodoCompletedInput 등의 input 타입과 CreateTodoPayload, ToggleTodoCompletedPayload 등의 payload 타입을 정의하여 mutation을 설계합니다.