Tech/graphql

Playground graphql 사용법

kimjingyu 2023. 5. 6. 19:57
728x90

플레이그라운드

  • 왼쪽 화면이 API 연습 화면이고, 오른쪽 화면이 API-docs이다.
  • !(느낌표)가 붙은 경우는 필수 입력값이다.

플레이그라운드 화면

1 단계: 이름으로 조회 (profile)

  • name은 동명이인이 있을 수 있기 때문에 백엔드에서 잘못 만들어진 API이다.

mutation - create

query (목록 조회)

query (상세 조회)

2단계: 게시글

  • 생성되는 게시글 번호(number)가 고유 번호이므로, 상세 조회 시에 number를 입력하여 원하는 값을 반환받게 된다.
  • 하지만, 이 API는 수정하는데 있어서 문제가 있다.

mutation - create

query - 상세 조회

mutation - update

  • 일반적으로 수정의 경우는 '어떤 게시글을 어떻게 수정해줘'라는 2가지 조건으로 나눠서 하게된다.
  • 하지만 이 경우에는 기준점에 대해 모호한 점이 있다.

수정 기준점 모호

  • 따라서 아래와 같이 수정의 기준점이 명확하게 API를 설계할 필요가 있다.
  • 조건과 대상이 나뉘었다.

수정 기준점 명확

3단계: 상품

mutation - create

  • 상품이 등록되면서, 상품 ID가 부여되었다.

query - 상세 조회

mutation - update

query - 상세 조회

fetchCount

728x90