API
Board
신고하기

Board API

신고 API

신고하기 서비스는 게임 내에서 부적절한 행동이나 불법적인 활동을 신고하는 데 사용됩니다. 부적절한 채팅, 사기 행위, 도박, 욕설 등의 신고가 포함됩니다.

유저 신고하기

사용자가 다른 유저를 신고하는 기능입니다.

Operation

mutation CreateUserComplaint($input: CreateUserComplaintInput!) {
  createUserComplaint(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "reportedUserNo": "신고 대상자 userNo",
    "complaintTypeIds": [1, 2],
    "description": "신고 상세 내용",
    "urls": ["http://example.com/image1.png"]
  }
}

신고 유형 목록 조회

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

Operation

query UserComplaintTypes {
  userComplaintTypes {
    id
    name
    description
  }
}

관리자 - 신고 API

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

[관리자] 유저 신고 처리

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

Operation

mutation AdminAddUserComplaintResponse($input: AddUserComplaintResponseInput!) {
  adminAddUserComplaintResponse(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "userComplaintId": "신고 고유 아이디",
    "status": "RESOLVED",
    "memo": "처리 메모"
  }
}

[관리자] 신고 대상자에게 메시지 전송

관리자가 신고 대상자에게 메시지를 전송하는 기능입니다.

Operation

mutation AdminAddUserComplaintMessage($input: AddUserComplaintMessageInput!) {
  adminAddUserComplaintMessage(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "userComplaintId": "신고 고유 아이디",
    "message": "전송할 메시지 내용"
  }
}

[관리자] 신고 내역 조회

이 API는 관리자가 신고 내역을 페이징 처리하여 상세 조회할 수 있게 해줍니다. 필터와 정렬 옵션을 사용하여 조회 조건을 세밀하게 조정할 수 있습니다.

Operation

query AdminUserComplaintConnection($first: Int, $offset: Int, $orderBy: UserComplaintConnectionOrderBy, $filter: UserComplaintConnectionFilter) {
  adminUserComplaintConnection(first: $first, offset: $offset, orderBy: $orderBy, filter: $filter) {
    nodes {
      id
      reporterUserId
      reportedUserId
      complaintTypes {
        id
        name
      }
      status
      createdAt
    }
    totalCount
  }
}

Variables

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

[관리자] 신고 내역 상세조회

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

Operation

query AdminUserComplaint($input: AdminUserComplaintInput!) {
  adminUserComplaint(input: $input) {
    userComplaint {
      id
      reporterUserId
      reportedUserId
      complaintTypes {
        name
      }
      status
      createdAt
    }
  }
}

Variables

{
  "input": {
    "id": "신고 고유 아이디"
  }
}

[관리자] 신고 처리내역 조회

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

Operation

query AdminUserComplaintResponse($input: AdminUserComplaintResponseInput!) {
  adminUserComplaintResponse(input: $input) {
    userComplaintResponses {
      createdAt
      adminUserNo
      status
      memo
    }
  }
}

Variables

{
  "input": {
    "userComplaintId": "신고 고유 아이디"
  }
}

[관리자] 신고 대상자에게 발송한 메시지 내역 조회

이 API는 관리자가 신고 대상자에게 발송한 메시지의 내역을 조회합니다.

Operation

query AdminUserComplaintMessage($input: AdminUserComplaintMessageInput!) {
  adminUserComplaintMessage(input: $input) {
    userComplaintMessages {
      createdAt
      adminUserNo
      targetUserNo
      message
    }
  }
}

Variables

{
  "input": {
    "userComplaintId": "신고 고유 아이디"
  }
}