API
Store
상품

Store API

상품 API

상품 서비스는 게임 내에서 판매되는 다양한 아이템들을 관리하고 제공합니다. 아바타, 가구, 스티커, 음원, 티켓과 같은 다양한 아이템들이 포함됩니다. 사용자는 상품 서비스를 통해 다양한 아이템을 검색하고 구매할 수 있습니다.

나의 아바타 상품 조회

프로필 생성 또는 수정 시 사용된다. 무료 에셋과 사용자가 소유한 아바타 상품을 조회합니다.

Operation

query MyAvatarProducts($orderBy: MyProductsOrderBy) {
  myAvatarProducts(orderBy: $orderBy) {
    faceShapes {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    eyebrows {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    eyes {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    noses {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    mouths {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    skinColors {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    faceStickers {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    hairs {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    tops {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    bottoms {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    onepieces {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    shoes {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    accessories {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
  }
}

Variables

{
  "orderBy": {
    "field": "CREATED_AT",
    "direction": "ASC"
  }
}

나의 가구 상품 조회

마이룸 생성 또는 수정 시 사용된다. 무료 에셋과 사용자가 소유한 가구 상품을 조회합니다.

Operation

query MyFurnitureProducts {
  myFurnitureProducts {
    wallpapers {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    floorings {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    furnitures {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    decors {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
  }
}

Variables

{
  "orderBy": {
    "field": "CREATED_AT",
    "direction": "ASC"
  }
}

나의 스티커 상품 조회

무료 에셋과 사용자가 소유한 스티커 상품을 조회합니다.

Operation

query MyStickerProducts {
  myStickerProducts {
    backgrounds {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    alphabets {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    numbers {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    emojis {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    symbols {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
  }
}

Variables

{
  "orderBy": {
    "field": "CREATED_AT",
    "direction": "ASC"
  }
}

나의 음원 상품 조회

디폴트 에셋과 사용자가 소유한 음원 상품을 조회합니다.

Operation

query MyMusicTrackProducts($orderBy: MyProductsOrderBy) {
  myMusicTrackProducts(orderBy: $orderBy) {
    id
    uuid
    name
    description
    genre
    artist
    album
    url
    thumbnailUrl
    isNew
    duration
  }
}

Variables

{
  "orderBy": {
    "field": "CREATED_AT",
    "direction": "ASC"
  }
}

상점의 아바타 상품 조회

상점에서 제공하는 모든 아바타 상품을 조회합니다.

Operation

query AvatarProducts {
  avatarProducts {
    faceShapes {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    eyebrows {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    eyes {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    noses {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    mouths {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    skinColors {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    faceStickers {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    hairs {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    tops {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    bottoms {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    onepieces {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    shoes {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    accessories {
      id
      uuid
      name
      description
      productAvatarType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
  }
}

상점의 가구 상품 조회

상점에서 제공하는 모든 가구 상품을 조회합니다.

Operation

query FurnitureProducts {
  furnitureProducts {
    wallpapers {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    floorings {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    furnitures {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    decors {
      id
      uuid
      name
      description
      productFurnitureType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
  }
}

상점의 스티커 상품 조회

상점에서 제공하는 모든 스티커 상품을 조회합니다.

Operation

query StickerProducts {
  stickerProducts {
    backgrounds {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    alphabets {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    numbers {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    emojis {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
    symbols {
      id
      uuid
      name
      description
      productStickerType
      point
      isPurchased
      isNew
      thumbnailUrl
    }
  }
}

상점의 음원 목록 조회

상점에서 제공하는 모든 음원을 조회합니다.

Operation

query MusicTrackProducts {
  musicTrackProducts {
    hiphop {
      id
      uuid
      name
      description
      point
      isPurchased
      isNew
      title
      url
      artist
      album
      genre
      duration
      thumbnailUrl
    }
    rnb {
      id
      uuid
      name
      description
      point
      isPurchased
      isNew
      title
      url
      artist
      album
      genre
      duration
      thumbnailUrl
    }
    pop {
      id
      uuid
      name
      description
      point
      isPurchased
      isNew
      title
      url
      artist
      album
      genre
      duration
      thumbnailUrl
    }
    synthpop {
      id
      uuid
      name
      description
      point
      isPurchased
      isNew
      title
      url
      artist
      album
      genre
      duration
      thumbnailUrl
    }
  }
}

탑승권 조회

특정 탑승권의 상세 정보를 조회합니다.

Operation

query TicketProduct($input: TicketInput!) {
  ticketProduct(input: $input) {
    id
    name
    point
  }
}

Variables

{
  "input": {
    "ticketType": "티켓 유형"
  }
}

아바타 상품 업데이트

클라이언트에서 아바타 관련 상품 변경이 있을 때 사용합니다.

Operation

mutation UpdateAvatarProducts($input: UpdateAvatarProductsInput!) {
  updateAvatarProducts(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "avatarProducts": [
      {
        "uuid": "unique-uuid",
        "name": "아바타 상품 이름",
        "description": "아바타 상품 설명",
        "productAvatarType": "상품 유형",
        "point": 100
      }
    ]
  }
}

가구 상품 업데이트

클라이언트에서 가구 관련 상품 변경이 있을 때 사용합니다.

Operation

mutation UpdateFurnitureProducts($input: UpdateFurnitureProductsInput!) {
  updateFurnitureProducts(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "furnitureProducts": [
      {
        "uuid": "unique-uuid",
        "name": "가구 상품 이름",
        "description": "가구 상품 설명",
        "productFurnitureType": "상품 유형",
        "point": 200
      }
    ]
  }
}

스티커 에셋 업데이트

클라이언트에서 스티커 관련 에셋 변경이 있을 때 사용합니다.

Operation

mutation UpdateStickerProducts($input: UpdateStickerProductsInput!) {
  updateStickerProducts(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "stickerProducts": [
      {
        "uuid": "unique-uuid",
        "name": "스티커 이름",
        "description": "스티커 설명",
        "productStickerType": "상품 유형",
        "point": 50
      }
    ]
  }
}
초대장구매