GET /guilds

엔드포인트: GET /v1/pdapi/guilds

인증: Bearer 토큰

필요 권한: REST.Guilds.Read

용도

서버가 알고 있는 길드의 요약 정보를 나열합니다. 특정 길드를 조회하기 전에 이 엔드포인트로 길드 ID를 확인하세요.

없습니다.

없습니다.

요청 본문은 없습니다.

필드	자료형	설명
`Meta`	객체	길드 목록 메타데이터입니다.
`Guilds`	객체	길드 UUID를 키로 하는 등록된 길드의 요약 정보입니다.

Meta 객체 스키마:

필드	자료형	설명
`GuildCount`	정수	반환한 길드 수입니다.

길드 요약 객체 스키마:

admin 객체 스키마:

필드	자료형	설명
`id`	문자열	관리자의 PlayerUID입니다.
`name`	문자열	관리자 플레이어 이름입니다.

camps[] 항목 스키마:

좌표 객체 스키마:

오류 응답 본문은 다음 형식을 사용합니다:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "사람이 읽을 수 있는 오류 메시지",
        "Details": {}
    }
}

HTTP	오류 코드	발생 조건
`401`	`INVALID_TOKEN`	`Authorization` 헤더가 없거나 형식이 잘못되었거나, 설정된 Bearer 토큰과 일치하지 않습니다.
`403`	`MISSING_PERMISSION`	토큰은 유효하지만 이 엔드포인트에 필요한 권한이 없습니다.
`400`	`INVALID_JSON`	요청 본문이 있지만 JSON으로 해석할 수 없습니다.
`400`	`REQUEST_FAILED`	게임 스레드 콜백에서 예외가 발생했거나 공통 플레이어/리소스 확인 처리에 실패했습니다.
`500`	`REQUEST_TIMEOUT`	내부 게임 스레드 콜백이 5초 안에 완료되지 않았습니다.

GET /v1/pdapi/guilds

GET /v1/pdapi/guilds