POST公开旧版五子棋棋局对弈SVGvv1

五子棋对局(旧版)

迁移自旧 GoBang:创建 15x15 五子棋棋局、按 A1/1A 落子、三三禁手、五连判胜、重置/结束,并输出 SVG 棋盘图。保留旧参数与错误码。

/api/GoBang
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

迁移自旧 GoBang:创建 15x15 五子棋棋局、按 A1/1A 落子、三三禁手、五连判胜、重置/结束,并输出 SVG 棋盘图。保留旧参数与错误码。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0string动作:create/play/end/reset,默认 create
keystring旧平台 key;新平台由 API Key 接管,仅兼容接收
posstring落子坐标,如 A1 或 1A
uidstring棋局 uid(play/end/reset/展示时必填)
formatstring动作别名,同 0
methodstring动作别名,次于 format
playerunion落子玩家 QQ(play 时必填)
player1union黑棋玩家 QQ(创建时必填)
player2union白棋玩家 QQ(创建时必填)

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "player1": "10001",
  "player2": "10002"
}

返回示例

response.json
{
  "code": 1,
  "message": "b8d3…(棋局 uid)"
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →