Chess.com Published Data

ゲームとスポーツ · Chess.com Published Data の結果 · 公開ソース

公式ドキュメント

ライブ検索

実際の語句を入力し、カードで返答を確認してから詳しいソースを開けます。

検索例

レスポンスに含まれる項目

magnuscarlsen、hikaru、fabianocaruana を試し、返された項目から目的のレコードを特定してください。

確認したい項目

ゲームとスポーツ
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 など固有の項目があり、存在しないキーをゼロと解釈してはいけません。

rating は表示する種目と日付の範囲内でだけ比較します。
数値が chess_rapid、chess_blitz、または別ブロックのどれに由来するか明記します。
画面に固定の項目を作る前に現在の応答を読みます。

見つからないアカウントと不完全なプロフィールは違います

存在しない username では、エンドポイントはユーザーが見つからないというメッセージとともに 404 を返しました。別のアカウントを自動的に推測するのではなく、識別子を修正する場面です。存在するプロフィールでも別のプロフィールにあるすべての項目を公開するとは限りません。各項目は任意のデータとして扱い、出典リンクを残してください。

404 には明確なメッセージを表示し、username の修正を促します。
確認済みプロフィール以外で followers、title、streaming を本人確認の証拠に使いません。
日付や公開プロフィールが作業に関係する場合は保存済みデータを更新します。