직접 답변

지원되는 플랫폼 샤드와 계정을 확인하고, 사용 가능한 매치를 가져온 후 관련 텔레메트리 자산 URL을 따라가세요. 자원을 플레이어로 계산하지 말고 유형과 ID별로 인덱싱하세요. 매치 메타데이터는 텔레메트리와 별도로 보존하여 다운로드 실패 시 모든 조회를 반복하지 않고 재시도할 수 있도록 합니다.

차량 이동 중, 개활지대
차량 이동 중, 개활지대 · PUBG: BATTLEGROUNDS — PUBG Corporation / KRAFTON, Inc. · 출처 페이지 ↗

계정 및 샤드 해결

공식 API가 지원하는 플랫폼 샤드와 필요한 계정부터 시작하세요. 표시 이름은 영구 데이터베이스 키가 아니라 조회 입력입니다. 반환된 계정 식별자를 플랫폼과 함께 저장하세요. 조회가 비어 있다면, 플레이어를 비활성 상태로 선언하기 전에 맞춤법과 플랫폼을 확인하세요. 베어러 토큰은 공개 HTML과 자바스크립트 외부의 개인 로컬 또는 서버 환경에 보관하세요.

관계를 통해 자원을 연결하세요

포함된 모든 객체를 플레이어로 계산하지 마세요. 명단은 참가자를 그룹화합니다; 참가자는 이 경기에서 플레이어의 외모를 나타냅니다. 자원 유형과 ID별로 인덱스를 만든 후 관계를 따라가세요. 자산, 명단, 참가자는 같은 응답에 나타나도 서로 다른 기록입니다. 조인을 테스트할 때 원본 응답을 유지하세요.

전통 건물 근처의 오토바이 점프
전통 건물 근처의 오토바이 점프 · PUBG: BATTLEGROUNDS — PUBG Corporation / KRAFTON, Inc. · 출처 페이지 ↗

반환된 자산 URL 사용하세요

매칭의 관련 텔레메트리 자산을 찾아 URL을 사용하세요; 날짜와 매치 ID에서 주소를 생성하지 마세요. 공식 텔레메트리 개요에는 자산 다운로드에 API 승인 헤더가 필요 없다고 명시되어 있습니다. 매칭 응답과 텔레메트리 문서를 별도의 입력으로 저장하여 실패한 다운로드가 이미 가져온 메타데이터를 버리지 않도록 하세요.

고장 처리 시 올바른 단계에서

플레이어 조회 실패가 텔레메트리 재시도 이유가 되지 않습니다. 매칭이 성공했지만 자산 다운로드가 실패하면, 해당 단계만 유한된 정책으로 재시도하세요. 고정된 요청 할당량을 복사하는 대신 API 속도 제한 헤더와 최신 문서를 읽으세요. 로그에서 빈 결과, HTTP 오류, 잘못된 JSON을 구분하여 나중에 조사가 올바른 단계부터 시작되도록 하세요.

참가하기 전에 리소스 신원을 검증하세요.

응답의 최상위 유형, ID 및 관계를 검사하세요. 참가자, 로스터 및 자산에 대해 별도의 인덱스를 구축하세요. 팀에 플레이어를 할당하기 전에 매치의 로스터 관계와 각 로스터의 참가자 관계를 따라가세요. 참조된 리소스가 누락된 경우 빈 팀으로 조용히 처리하지 말고 명시적인 검증 결과를 생성하세요. 파생 테이블과 함께 원래 ID를 저장하세요. 나중에 집계 과정에서 플레이어가 중복될 경우, 텔레메트리를 탓하기 전에 소스 응답과 조인 경로를 비교하세요. 매치 리소스와 텔레메트리 이벤트 문서는 다른 입력으로, 각기 다른 파서를 필요로 합니다.

전체 파이프라인이 아니라 실패한 단계만 재시도하세요.

요청 단계, HTTP 상태 및 리소스 ID를 로그에 남기되, 베어러 토큰은 기록하지 마세요. 사용 불가 매치, 요청 제한, 자산 전송 실패 및 잘못된 JSON을 구분하세요. 제한된 재시도를 위해 문서화된 응답 정보를 사용하세요. 공식 텔레메트리 개요에 따르면 자산 다운로드는 API 인증 헤더가 필요하지 않으므로, 토큰을 임의 자산 호스트에 보내지 마세요. 성공적인 HTTP 응답이라도 예상 형태를 검증해야 합니다. 매치 메타데이터를 캐시하여 텔레메트리를 재시도할 때 플레이어를 재해결할 필요가 없도록 하세요. 방문자에게 공개 정적 페이지에 API 비밀을 붙여넣으라고 절대 요청하지 마세요.

성공적인 결정 예시

예시 워크플로우: 플레이어 조회 성공, 매치 메타데이터 성공, 텔레메트리 전송 실패. 처음 두 결과를 보존하고 제한된 정책 하에서 자산 요청만 재시도하세요. 나중에 자산이 파싱되면, 계산 전 해당 매치에 속하는지 검증하세요.

범위와 증거

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

다음에 할 때

  1. 토큰은 비공개로 유지하세요.
  2. 리소스 유형과 ID로 가입하세요.
  3. 반환된 텔레메트리 URL을 사용하세요.

선택된 공식 참조

  1. Matches endpoint ↗2026년 11월 16일 수집
  2. Players endpoint ↗2026년 11월 16일 수집
  3. Telemetry overview ↗2026년 11월 16일 수집
  4. API rate limits ↗2026년 11월 16일 수집
  5. Making requests ↗2026년 11월 16일 수집

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