Go Problem API

Access over 49000+ (Go/Weiqi/Baduk/หมากล้อม) API tsumego problems for all levels. Features include random problem retrieval by rank and solution verification.

原始信息汇总

Go Problem API 数据集概述

基本信息

• 数据集名称: Go Problem API
• 类别: Gaming
• 提供者: Apisit Thananchai
• 订阅用户数: 1

数据集描述

该API提供对海量围棋（Weiqi/Baduk）题目（Tsumego）的访问，旨在帮助开发者构建下一代围棋应用程序。

核心数据内容

• 数据规模: 超过 49,500+ 道围棋题目。
• 难度范围: 从 30 级（初学者）到 段位（大师级）。
• 数据格式: 题目以标准的智能棋谱格式（SGF）返回。
• 数据内容: 包含初始棋盘设置、正确答案路径以及错误变化分支。
• 元数据: 每道题目包含等级（rank）、行棋方（player to move）、类型（genre，如死活题）和难度描述。

主要功能与用途

• 随机获取题目: 根据目标等级获取随机题目。
• 提交解题尝试: 记录用户的解题结果，并标记该题目对该用户为“已解决”，避免重复出现。
• 获取用户统计: 查询特定用户的解题进度和表现指标。
• 应用场景: 可用于构建移动训练应用、学习平台、社区机器人（如Discord/Telegram机器人）。

接口与访问

• 基础地址: https://go-problem-api.p.rapidapi.com
• 当前版本: v1
• 认证方式: 需在请求头中包含 RapidAPI Key (x-rapidapi-key) 和主机信息 (x-rapidapi-host: go-problem-api.p.rapidapi.com)。

可用端点

1. GET /v1/problem

   • 功能: 获取随机题目。
   • 必需参数: userId（用于标识用户并跟踪“已见”题目）。
   • 可选参数: rank（目标难度，如“10k”）。

2. POST /v1/attempt

   • 功能: 提交解题尝试。
   • 必需参数（JSON Body）: userId, problemId, isCorrect。

3. GET /v1/stats

   • 功能: 获取用户统计数据。
   • 必需参数: userId。

响应示例

• 获取题目响应: 包含成功状态、题目ID、等级显示、SGF内容及题目信息（类型、行棋方、描述）。
• 提交尝试响应: 包含成功状态和记录信息。
• 用户统计响应: 包含成功状态、总结信息（总题数、用户解题数、进度百分比）及按等级细分的解题情况。

技术细节

• SGF格式: 返回的sgf_content字段为标准SGF数据，包含初始设置、解答树和元数据。
• 推荐渲染库: WGo.js, Glift, Besogo。
• 错误码: 使用标准HTTP状态码（200, 400, 401, 404, 429, 500）。

支持与反馈

• 可通过讨论区报告错误题目或提出功能请求。

搜集汇总

背景与挑战

背景概述

该数据集提供超过4.9万道围棋题目的API访问服务，支持按难度等级随机获取题目，并包含解答验证功能。