직접 답변

API 가용성과 분석 실패를 분리하세요. 데이터를 잃었다고 선언하기 전에 샤드, 식별자, 응답 상태 및 문서화된 가용성을 확인하세요. 한 플레이어의 매치에 의존하지 않고 공식 샘플을 사용하여 파싱을 테스트하세요. 없는 필드를 플레이어 행동으로 해석하기 전에 알려진 문제와 버전별 이벤트 정의를 확인하세요.

바위 높은 지대에 무장한 플레이어가 있다
바위 높은 지대에 무장한 플레이어가 있다 · PUBG: BATTLEGROUNDS — PUBG Corporation / KRAFTON, Inc. · 출처 페이지 ↗

의도된 리소스를 확인하세요.

플랫폼, 계정 ID 및 매치 ID를 함께 기록하세요. 결과가 비어 있을 때 조회 입력을 다시 확인하고 요청을 공식 엔드포인트 형식과 비교하세요. 표시명이 영구 식별자가 아닙니다. 재시도하기 전에 리소스가 API 문서화 범위 내에 있는지 확인하세요. 이 가이드는 고정된 보존 약속을 피하는데, 가용성 규칙은 최신 문서를 참조해야 하기 때문입니다. 이전에 로컬에 저장된 매치와 현재 검색 가능한 매치는 다른 세트일 수 있으므로, 유용한 입력은 가능할 때 보존하세요.

전송, 파싱 및 해석을 분리하세요.

HTTP 오류는 잘못된 JSON과 다르며, 올바른 JSON은 파서가 기대하는 스키마와 다릅니다. 비밀 없이 이러한 단계를 별도로 기록하세요. 필드가 없을 때 짧은 원시 샘플을 점검하고, 이벤트 유형과 버전을 확인하세요. 파서의 기본값을 사실상의 0으로 전환하지 마세요. 알려진 문제는 코드가 실행되더라도 결론에 제한을 줄 수 있습니다. 원래 응답과 재현 가능한 작은 사례를 유지하여 다른 읽는 사람이 데이터 제한과 변환 버그를 구별할 수 있도록 하세요.

컨테이너 야드에서의 근접 조우
컨테이너 야드에서의 근접 조우 · PUBG: BATTLEGROUNDS — PUBG Corporation / KRAFTON, Inc. · 출처 페이지 ↗

샘플을 사용하여 파서 동작을 분리하세요.

공식 샘플 엔드포인트는 문서화된 요청 규칙 하에서 샘플 매치 참조를 얻는 방법을 제공합니다. 알려진 형식의 저장된 입력을 사용하여 리소스 조인과 이벤트 파싱을 테스트하세요. 샘플 테스트가 성공했다고 해서 모든 플레이어 매치가 사용 가능하다는 증거는 아니지만, 파서 문제인지 요청한 리소스 문제인지를 좁히는 데 도움이 됩니다. 샘플 출력은 명확히 표시하고, 사용자의 통계처럼 표시하지 마세요. 이후 이벤트 버전에서 필드가 변경되면, 원래 입력을 유지하고 정상화 업데이트를 의도적으로 수행하세요.

제한된 결론을 포함한 보고서를 작성하세요.

엔드포인트, 플랫폼, 상태, 조회 시간 및 최소 입력(편집됨)을 포함하세요. 모든 것이 작동하지 않는다고 말하는 대신 예상 필드와 실제 이벤트 유형을 설명하세요. 관련 알려진 문제와 해결되지 않는 사항을 언급하세요. 증거가 불충분한 경우, 그럴듯한 이벤트를 재구성하지 말고 결과를 사용할 수 없거나 알 수 없음으로 표시하세요. 작업대는 로컬 노트를 보관할 수 있지만 PUBG에 인증하거나 개인 계정 데이터를 가져오지 않습니다. 지원되는 개인 환경에서 요청을 수행하고 스크린샷이나 보고서에 베어러 토큰을 공유하지 마세요.

성공적인 결정 예시

예시: 샘플은 올바르게 파싱되지만 요청된 경기 중 하나가 이용 불가 오류를 반환합니다. 파서 테스트와 리소스 실패를 분리해서 유지하세요. 경기의 샤드와 문서화된 범위를 확인한 후 증거가 그 결론만 지지한다면 이용 불가로 보고하세요. 피해 공식(damage formula)을 반복적으로 변경해도 이용 불가 응답을 복원할 수 없습니다.

범위와 증거

설치된 빌드, 플랫폼 및 사용 가능한 기능을 확인하십시오. 과거 공지는 명시된 버전을 설명하며, 실례는 설명일 뿐 실제 플레이 테스트를 주장하는 것은 아닙니다.

다음에 할 때

  1. API 가용성과 분석 실패를 분리하세요. 데이터를 잃었다고 선언하기 전에 샤드, 식별자, 응답 상태 및 문서화된 가용성을 확인하세요. 한 플레이어의 매치에 의존하지 않고 공식 샘플을 사용하여 파싱을 테스트하세요. 없는 필드를 플레이어 행동으로 해석하기 전에 알려진 문제와 버전별 이벤트 정의를 확인하세요.

선택된 공식 참조

  1. Matches endpoint ↗2026년 11월 16일 수집
  2. Samples endpoint ↗2026년 11월 16일 수집
  3. Known issues ↗2026년 11월 16일 수집
  4. API versioning ↗2026년 11월 16일 수집
  5. Making requests ↗2026년 11월 16일 수집

출처는 이전 기능이 변하지 않았다는 약속이 아닙니다. 세부 사항이 다를 때는 현재 게임 내 설명을 따르세요.