User API

프로필 API

프로필 서비스는 게임 내에서 사용자의 개인 정보와 설정을 관리하고 표시하는 데 사용됩니다.

내 프로필 조회

사용자가 자신의 프로필 정보를 조회할 때 사용합니다. 헤더에 담긴 토큰 정보를 사용하여 조회합니다. 별도의 입력 변수는 필요하지 않습니다.

Operation

query MyProfile {
  myProfile {
    id
    nickname
    birthdate
    thumbnailUrl
    level
    point
    avatarProducts {
      hair {
        productId
      }
      faceShape {
        productId
      }
    }
  }
}

유저 프로필 조회

특정 사용자의 프로필 정보를 조회할 때 사용합니다.

Operation

query Profile($input: ProfileInput!) {
  profile(input: $input) {
    id
    nickname
    birthdate
    thumbnailUrl
    personalSpaceUrl
    avatarProducts {
      hair {
        productId
      }
    }
  }
}

Variables

{
  "input": {
    "id": "프로필 ID"
  }
}

프로필 생성

사용자가 자신의 프로필을 생성합니다.

Operation

mutation CreateProfile($input: CreateProfileInput!) {
  createProfile(input: $input) {
    id
  }
}

Variables

{
  "input": {
    "nickname": "사용자 닉네임",
    "birthdate": "사용자 생년월일",
    "thumbnailUrl": "썸네일 이미지 URL",
    "statusType": "DEFAULT",
    "avatarProducts": [
      {
        "productId": "상품 ID",
        "uuid": "에셋 유니크 ID",
        "productAvatarType": "FACE_SHAPE"
      }
    ]
  }
}

프로필 수정

사용자가 자신의 프로필 정보를 수정합니다.

Operation

mutation UpdateProfile($input: UpdateProfileInput!) {
  updateProfile(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "id": "프로필 ID",
    "statusType": "HAPPY",
    "statusDescription": "새로운 상태 설명",
    "thumbnailUrl": "새 썸네일 이미지 URL",
    "avatarProducts": [
      {
        "productId": "새 상품 ID",
        "uuid": "새 에셋 유니크 ID",
        "productAvatarType": "HAIR"
      }
    ],
    "bgmEnabled": true
  }
}

내 배경 스티커로 저장

사용자가 배경 스티커를 자신의 컬렉션에 저장합니다.

Operation

mutation SaveMyBackgroundSticker($input: SaveMyBackgroundStickerInput!) {
  saveMyBackgroundSticker(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "url": "배경 스티커 이미지 URL"
  }
}

내 배경 스티커 삭제

사용자가 자신의 컬렉션에서 배경 스티커를 삭제합니다.

Operation

mutation RemoveMyBackgroundSticker($input: RemoveMyBackgroundStickerInput!) {
  removeMyBackgroundSticker(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "id": "배경 스티커 ID"
  }
}

내 배경 스티커 목록 조회

사용자가 보유한 배경 스티커 목록을 조회합니다. 별도의 입력 변수는 필요하지 않습니다.

Operation

query MyBackgroundStickers {
  myBackgroundStickers {
    backgroundStickers {
      id
      url
      createdAt
    }
  }
}

캐릭터 모션 목록 조회

사용 가능한 모든 캐릭터 모션을 조회합니다. 별도의 입력 변수는 필요하지 않습니다.

Operation

query CharacterMotions {
  characterMotions {
    characterMotions {
      id
      name
      description
    }
  }
}

즐겨찾는 캐릭터 모션 목록 조회

사용자가 즐겨찾기 한 캐릭터 모션 목록을 조회합니다. 별도의 입력 변수는 필요하지 않습니다.

Operation

query FavoriteCharacterMotions {
  favoriteCharacterMotions {
    characterMotions {
      id
      name
      description
      index
    }
  }
}

즐겨찾는 캐릭터 모션 목록 업데이트

사용자가 자신의 즐겨찾는 캐릭터 모션 목록을 업데이트합니다.

Operation

mutation UpdateCharacterMotionFavorites($input: UpdateCharacterMotionFavoritesInput!) {
  updateCharacterMotionFavorites(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "characterMotions": [
      {
        "id": "캐릭터 모션 ID",
        "index": 0
      }
    ]
  }
}

회원 퍼스널스페이스