플레이어 신고 웹 API

플레이어 신고 웹 API를 사용하여 RESTful 서비스로 플레이어 신고 인터페이스 기능을 사용합니다.

5 분 소요

API 엔드포인트

https://api.epicgames.dev/player-reports/v1/report

새 플레이어 신고 전송

정책

사용하는 클라이언트 정책에는 다음 권한이 있어야 합니다.

playerreports:sendReportForAnyUser: 클라이언트가 플레이어 대신 신고를 전송할 권한이 있는 경우입니다. 일반적으로 신고가 게임 서버에서 오는 경우입니다.

인증

이 호출은 연결 인터페이스에서 얻은 EOS 클라이언트 인증 액세스 토큰을 통한 Bearer 토큰 인증이 필요합니다.

요청

HTTP 요청	`POST /player-reports/v1/report`
HTTP 헤더
이름	값
`Content-Type`	`application/json`
요청 바디
이름	유형	설명	필수 여부
`reportingPlayerId`	String	신고하는 EOS `productUserId`입니다.	예
`reportedPlayerId`	String	신고된 EOS `productUserId`입니다. `reportingPlayerId`와 달라야 합니다.	예
`time`	String	ISO 8601 및 RFC3339 정의 기준의 신고가 발행된 시각입니다. 예를 들면 `2021-01-01T00:00:00.000Z`입니다.	예
`reasonId`	Integer	신고 사유 ID입니다. 유효한 ID여야 합니다. 자세한 정보는 `/player-reports/v1/report/reason/definition` API 엔드포인트를 참고하세요.	예
`message`	String	최대 길이가 1,024자인 신고 메시지입니다.	아니요
`context`	String	모든 유효한 JSON입니다. 개발자에게 유용한 것으로 여겨지는 모든 관련 정보입니다. 최대 길이는 4,096자입니다.	아니요

요청 예시

응답

HTTP 응답 201 - 생성됨: 성공.

플레이어 신고 찾기

정책

사용하는 클라이언트 정책에는 다음 권한이 있어야 합니다.

playerreports:findReportsForAnyUser: 클라이언트가 모든 플레이어의 신고를 가져올 권한이 있는 경우입니다.

인증

이 호출은 연결 인터페이스에서 얻은 EOS 클라이언트 인증 액세스 토큰을 통한 Bearer 토큰 인증이 필요합니다.

요청

HTTP 요청	`GET /player-reports/v1/report/{deploymentId}`
요청 파라미터
이름	유형	설명	필수 여부
`deploymentId`	String	EOS `deploymentId`입니다. 액세스 토큰에서 생성된 `deploymentId`와 같아야 합니다.	예
`reportingPlayerId`	String	신고하는 EOS `productUserId`입니다. `reportingPlayerId` 및 `reportedPlayerId`는 둘 다 비워 두면 안 됩니다.	아니요
`reportedPlayerId`	String	신고된 EOS `productUserId`입니다. `reportingPlayerId` 및 `reportedPlayerId`는 둘 다 비워 두면 안 됩니다.	아니요
`reasonId`	Integer	신고 사유 ID입니다. 유효한 ID여야 합니다. 자세한 내용은 */player-reports/v1/report/reason/definition* API 엔드포인트를 참고하세요.	아니요
`startTime`	String	`startTime` 이후에 발행된 신고를 반환합니다. ISO 8601 및 RFC3339 정의 기준의 신고가 발행된 시각입니다. * 예시: 2021-01-01T00:00:00.000Z*	아니요
`endTime`	String	`endTime` 이전에 발행된 신고를 반환합니다. ISO 8601 및 RFC3339 정의 기준의 신고가 발행된 시각입니다. 예를 들면 `2021-01-01T00:00:00.000Z`입니다.	아니요
`pagination`	Boolean	페이지네이션 응답을 활성화하거나 비활성화합니다. 디폴트: false	아니요
`offset`	Integer	페이지네이션 오프셋입니다. 디폴트: 0	아니요
`limit`	Integer	호출당 반환된 신고 수입니다. 디폴트: 50	아니요
`order`	String	반환된 신고 이전에 표시되는 순서입니다. 가능한 값: `time:desc` `time:asc` `reasonId:asc` `reasonId:desc` 디폴트: time:desc	아니요

요청 예시

응답

HTTP 응답 200 - OK: 성공.
HTTP 헤더
이름		값
`Content-Type`		`application/json`
JSON 페이로드
이름	유형	설명
`elements`	배열<신고>	신고 목록입니다.
`paging`	객체<페이징>	페이지네이션 정보

페이징

페이징
이름	유형	설명
`offset`	Integer	페이지네이션 오프셋입니다.
`limit`	Integer	호출당 반환된 신고 수입니다.
`total`	Integer	총 신고 수입니다.

신고
이름	유형	설명
`productId`	String	게임 EOS `productId`입니다.
`sandboxId`	String	게임 EOS `sandboxId`입니다.
`deploymentId`	String	게임 EOS `deploymentId`입니다.
`time`	String	ISO 8601 및 RFC3339 정의 기준의 신고가 발행된 시각입니다. 예를 들면 `2021-01-01T00:00:00.000Z`입니다.
`reportingPlayerId`	String	신고하는 EOS `productUserId`입니다.
`reportedPlayerId`	String	신고된 EOS `productUserId`입니다.
`reasonId`	Integer	신고의 `reasonId`입니다.
`message`	String	신고 내용입니다.
`context`	String	신고 컨텍스트입니다.

응답 예시

신고 사유 정의 가져오기

정책

신고 정의 API 호출에는 특별한 클라이언트 권한이 필요하지 않습니다.

인증

이 호출은 연결 인터페이스에서 얻은 EOS 클라이언트 인증 액세스 토큰을 통한 Bearer 토큰 인증이 필요합니다.

요청

HTTP 요청	`GET /player-reports/v1/report/reason/definition`

요청 예시

응답

HTTP 응답 200 - OK: 성공.
HTTP 헤더
이름		값
`Content-Type`		`application/json`
JSON 페이로드
이름	유형	설명
`elements`	배열<ReportReason>	신고 사유 목록입니다.

ReportReason

ReportReason
이름	유형	설명
`reasonId`	Integer	신고 사유 ID입니다
`reasonString`	String	`reasonId`를 설명하는 스트링입니다.