#76 井字棋（三子版）

接口地址

http://api.typh.top/openapi/jzq_two

请求方式

GET

返回类型

JSON

参数说明

n：动作编号。1 创建房间；0 销毁房间；2 落子；3 初始化头像；4 查看棋盘；5 更新头像。
qun：房间号，创建、销毁、落子、查看都要保持一致。
q1：玩家 1 QQ，创建房间必填，三子版中为 X。
q2：玩家 2 QQ，创建房间必填，三子版中为 O。
qq：当前落子玩家 QQ，落子时必填。
x：落子横坐标，接口传数字，从 1 开始；图片上横轴显示 A-C，x=1 对应 A。
y：落子纵坐标，接口传数字，从 1 开始；图片左侧显示 1-3。
规则：每方最多保留 3 颗棋子，继续落子会移除该玩家最早的一颗棋子。

请求示例

创建：http://api.typh.top/openapi/jzq_two?n=1&qun=10001&q1=10001&q2=10002
落子：http://api.typh.top/openapi/jzq_two?n=2&qun=10001&qq=10001&x=2&y=2 （图片位置 B2）
查看：http://api.typh.top/openapi/jzq_two?n=4&qun=10001

返回示例

{
  "success": true,
  "game": "[游戏标识：wzq / jzq / jzq_two]",
  "action": "[动作编号：1创建 / 2落子 / 4查看 / 0销毁]",
  "action_name": "[动作名称：create / move / view / destroy]",
  "message": "[本次操作结果提示]",
  "room_id": "[房间号 qun]",
  "players": {
    "black_or_x": "[玩家1 QQ]",
    "white_or_o": "[玩家2 QQ]"
  },
  "current_player": "[下一步该谁落子，返回 QQ]",
  "winner": "[获胜玩家 QQ；未获胜时为空字符串]",
  "board": "[棋盘数组，二维数组，每格是空字符串 / B / W / X / O]",
  "moves": "[落子记录数组，包含 qq、x、y、point、mark；point 例如 A1/H8]",
  "image": {
    "type": "image",
    "url": "[完整棋盘图片链接，例如：https://你的域名/static/generated/wzq_xxx.svg]"
  },
  "usage": {
    "create": "[创建房间链接]",
    "move": "[落子链接]",
    "view": "[查看棋盘链接]",
    "destroy": "[销毁房间链接]"
  }
}

图片预览样板

这是这个接口真实生成或真实返回的固定样张，别人调用时会按参数重新生成并返回图片链接。

额外说明

第三颗后继续落子会移除该玩家最早棋子。 井字棋（三子版） 同井字棋；每方最多保留 3 颗棋子

调用说明

这是一个多动作游戏 API，不是单纯图片接口。创建、落子、查看、销毁都走同一个地址，通过 n 参数区分动作；返回统一 JSON，棋盘图片放在 image.url 字段里。