Chess Puzzles

Query a database of over 2 million Chess Puzzles

原始信息汇总

Chess Puzzles API 数据集概述

数据集基本信息

• 数据集名称：Chess Puzzles
• 数据集类别：Gaming（游戏）
• 数据来源：LiChess（非官方，第三方解决方案）
• 数据源链接：https://database.lichess.org/#puzzles
• 最后更新日期：2021年10月12日
• 当前谜题数量：2,137,287
• 数据格式：JSON

数据集内容

• 数据描述：包含超过200万个国际象棋谜题的数据库。
• 数据字段：
  • puzzleid：谜题唯一标识符。
  • fen：对手走棋前的棋盘位置（FEN格式）。
  • moves：走棋序列（UCI格式）。
  • rating：谜题评分。
  • ratingdeviation：评分偏差。
  • themes：谜题主题标签数组。

数据访问与查询

• 基础访问：访问API根路径（/）返回一个随机谜题。
• 查询参数：
  • id：通过ID获取特定谜题。
  • rating：获取指定评分范围内的谜题。
  • count：指定返回的谜题数量（1到500之间）。
  • themes：按主题筛选谜题（需传入数组）。
  • themesType：当使用多个主题时，指定匹配逻辑（ALL 或 ONE）。
  • playerMoves：按玩家需走棋步数筛选谜题。

使用说明

• 谜题呈现：向玩家展示的位置是初始FEN应用第一步走棋后的棋盘状态。
• 走棋格式：走棋使用UCI格式，需通过象棋库转换为SAN格式以进行显示。
• 错误处理：无效ID会返回状态400错误。