API
Board
문의하기

Board API

문의 API

문의하기 서비스는 사용자가 게임 관련 문의나 의견을 개발자나 관리자에게 전달하는 데 사용됩니다. 기술적인 문제, 게임 관련 질문, 건의사항 등을 포함합니다.

문의 유형 조회

이 API는 사용자가 문의할 때 사용할 수 있는 모든 문의 유형을 조회합니다.

Operation

query UserInquiryTypes {
  userInquiryTypes {
    id
    name
    description
  }
}

유저 문의하기

사용자가 서비스에 문의를 등록하는 기능입니다.

Operation

mutation CreateUserInquiry($input: CreateUserInquiryInput!) {
  createUserInquiry(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "inquiryTypeIds": [1],
    "description": "문의 상세 내용",
    "email": "user@example.com",
    "urls": ["http://example.com/image1.png"]
  }
}

관리자 - 문의 API

Admin 권한이 있는 사용자만 접근이 가능합니다.

[관리자] 유저 문의 처리

관리자가 사용자의 문의를 처리하는 기능입니다.

Operation

mutation AdminAddUserInquiryResponse($input: AddUserInquiryResponseInput!) {
  adminAddUserInquiryResponse(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "userInquiryId": "문의 고유 아이디",
    "status": "RESOLVED",
    "memo": "처리 메모"
  }
}

[관리자] 문의 내역 조회

이 API는 관리자가 사용자의 문의 내역을 페이징 처리하여 상세 조회할 수 있게 해줍니다.

Operation

query AdminUserInquiryConnection($first: Int, $offset: Int, $orderBy: UserInquiryConnectionOrderBy, $filter: UserInquiryConnectionFilter) {
  adminUserInquiryConnection(first: $first, offset: $offset, orderBy: $orderBy, filter: $filter) {
    nodes {
      id
      userNo
      inquiryTypes {
        name
      }
      status
      createdAt
    }
    totalCount
  }
}

Variables

{
  "first": 10,
  "offset": 0,
  "orderBy": {
    "field": "CREATED_AT",
    "direction": "DESC"
  },
  "filter": {
    "keyword": "검색 키워드",
    "status": "PENDING"
  }
}

[관리자] 문의 내역 상세조회

이 API는 관리자가 특정 문의 내역의 상세 정보를 조회합니다.

Operation

query AdminUserInquiry($input: AdminUserInquiryInput!) {
  adminUserInquiry(input: $input) {
    userInquiry {
      id
      userNo
      inquiryTypes {
        name
      }
      status
      description
      createdAt
    }
  }
}

Variables

{
  "input": {
    "userInquiryId": "문의 고유 아이디"
  }
}

[관리자] 문의 처리내역 조회

이 API는 관리자가 특정 문의에 대한 처리 내역을 조회합니다.

Operation

query AdminUserInquiryResponse($input: AdminUserInquiryResponseInput!) {
  adminUserInquiryResponse(input: $input) {
    userInquiryResponses {
      createdAt
      adminUserNo
      status
      memo
    }
  }
}

Variables

{
  "input": {
    "userInquiryId": "문의 고유 아이디"
  }
}