응답에 포함된 항목
magnuscarlsen, hikaru 및 fabianocaruana을/를 입력하고 반환된 필드로 알맞은 레코드를 찾으세요.
확인할 필드
- 게임과 스포츠
- Chess.com Published Data 결과
- 공개 출처
Chess.com Published Data
게임과 스포츠 · Chess.com Published Data 결과 · 공개 출처
라이브 조회
실제 검색어를 입력하고 카드 결과를 확인한 뒤 전체 출처를 열어 보세요.
빠른 예시
표시 이름이 아니라 username부터 시작하세요
/pub/player/{username} 엔드포인트는 username으로 공개 계정을 조회합니다. 응답에는 username, player_id, url, name, title, followers, country, location, joined, last_online, status가 포함될 수 있습니다. name은 표시 이름이므로 참조를 저장하거나 다른 요청을 만들 때는 username을 우선하고, 가능하면 player_id도 함께 보관하세요.
- 표시 이름의 공백이나 문장 부호를 복사하지 말고 URL에는 username 값을 사용하세요.
- 프로필을 특정 인물에게 연결하기 전에 url을 열어 공개 페이지를 확인하세요.
- country는 국가 이름이 아니라 API URL일 수 있습니다.
프로필과 통계는 서로 다른 질문에 답합니다
공개 프로필은 계정을 설명합니다. 종목별 결과에는 /pub/player/{username}/stats를 사용하세요. 현재 응답에는 chess_daily, chess_rapid, chess_bullet, chess_blitz, tactics, puzzle_rush 블록과 제공되는 경우 fide가 있었습니다. 각 블록에는 last, best, record 같은 자체 필드가 있을 수 있으므로 없는 키를 0으로 해석하면 안 됩니다.
- rating은 표시하는 종목과 날짜 안에서만 비교하세요.
- 숫자가 chess_rapid, chess_blitz 또는 다른 블록에서 왔는지 분명히 밝히세요.
- 인터페이스에 고정 필드를 만들기 전에 현재 응답을 읽으세요.
알 수 없는 계정과 불완전한 프로필은 다릅니다
존재하지 않는 username에 대해 엔드포인트는 사용자를 찾을 수 없다는 메시지와 함께 404를 반환했습니다. 다른 계정을 자동으로 추측하는 대신 식별자를 수정해야 합니다. 존재하는 프로필도 다른 프로필에서 본 모든 필드를 공개하지 않을 수 있으므로 각 필드를 선택적 데이터로 다루고 출처 링크를 유지하세요.
- 404에는 명확한 메시지를 표시하고 username 수정을 안내하세요.
- 확인한 프로필 밖에서 followers, title, streaming을 신원 증명으로 사용하지 마세요.
- 날짜나 공개 프로필이 작업에 중요하면 저장된 데이터를 갱신하세요.