攻城略地API文档

API

用户使用

1. 首页（仅有一张地图）

• 请求URL
  

  132.232.27.211:13920/

• 请求方式
  GET
• 请求参数
  无
• 返回参数
  
  • 一张地图，棋盘全部标红。
• 返回参数解释
  这里解释一样可视化图片的传输，本次游戏所有的可视化图片全部使用base64进行转码，在浏览器中可以正常显示的原因是因为浏览器进行了渲染，所以请同学们自行编程进行解码以获得可视化界面。

2. 获取题目（不含可视化界面）

• 请求内容
  这个URL返回随机生成的本局规则，以及电脑先行落子后的结果。
• 请求URL
  

  132.232.27.211:13920/register

• 请求方式
  GET
• 请求参数
  无
• 返回参数
  
  • JSON文件

[
    {
        rules: [
            [
            "Jiangsu",
            "Sichuan"
            ],
            ...
            [
            "Nei_Mongol",
            "Sichuan"
            ]
        ]
    },
    {
        your_castle: "",
        computer_castle: [
        "Jiangsu",
        "Beijing",
        "Guangdong",
        "Jiangxi",
        "Nei_Mongol",
        "Shaanxi",
        "Sichuan",
        "Tianjin",
        "Hong_Kong"
        ]
    },
    {
        your_choice: "",
        computer_choice: "Jiangsu"
    },
    {
        key: -4686482580493518000
    }
]

• 返回参数解释
  
  • rules：顾名思义，这里就是获取到的本局的游戏规则。
  • your_castle：你所占领的地盘，由于刚刚获取到规则，所以这里为空。
  • computer_castle：电脑所占领的地盘，也就是电脑第一次落子地点以及它所“生”的地盘。
  • your_choice：你即将落子时所要填写的，所以也为空。
  • computer_choice：电脑第一次落子所选择的地点。
  • key：密钥，是由当前棋盘状态以及本局规则所生成。

3. 获取题目（含有可视化界面）

• 请求内容
  与上述相同，只不过多返回两张图片。
• 请求URL
  

  132.232.27.211:13920/register_image

• 请求方式
  GET
• 请求参数
  无
• 返回参数
  
  • 图片1
  • 图片2
  • JSON文件

[
    {
        rules: [...]
    },
    {
        your_castle: "",
        computer_castle: [...]
    },
    {
        your_choice: "",
        computer_choice: "Jiangsu"
    },
    {
        key: -4686482580493518000
    }
]

• 返回参数解释

  • 图片1:返回一张没有任何颜色的棋盘。
  • 图片2:返回一张由电脑第一次落子之后的棋盘。
  • JSON文件：与上述相同。

  ---

4. 对战界面（不含可视化界面）

• 请求内容
  发送规则，棋盘现状，落子以及密钥，已获得电脑落子。
• 请求URL
  

  132.232.27.211:13920/play

• 请求方式
  POST
• 请求参数

[
    {
        rules: [...]
    },
    {
        your_castle: "",
        computer_castle: [...]
    },
    {
        your_choice: "自己的落子",
        computer_choice: "..."
    },
    {
        key: ...
    }
]

• 请求参数解释
  rules/your_castle/computer_castle/key 这四项参数请原封不动，然后在your_choice的键值上填写由你程序算出的最佳落子选择。前四项参数不动目的是为了验证棋盘内容为真，如果四项参数有一项与之前不同，则无法通过验证，那么服务器不会返回下一次的落子。

• 返回参数

[
    {
        rules: [...]
    },
    {
        your_castle: "",
        computer_castle: [...]
    },
    {
        your_choice: "...",
        computer_choice: "电脑本局的落子"
    },
    {
        key: ...
    }
]

• 返回参数解释

  • 服务器会根据的你落子自动更新棋盘，然后落子，然后再次更新棋盘之后返回给你。
  • 值得注意的是，这里的key会有不同的状态：
    
    • 一串数字：说明棋盘yanzhengguo验证通过，并且在你落子之后以及电脑落子之后并没有把所有领地占满，游戏继续。
    • “抱歉，密钥匹配失败，请重新尝试！”
    • “抱歉，您选择的城堡已经被己方占领，请重新尝试！”
    • “抱歉，您选择的城堡已经被对方占领，请重新尝试！”
    • “抱歉，您选择的城堡不在中国的省份内，请重新尝试！”
    • “恭喜你，您的游戏结束了，最后得分是：”

5. 对战界面（含有可视化界面）

• 请求内容
  与上述相同，只不过多返回两张图片。
• 请求URL
  

  132.232.27.211:13920/play_image

• 请求方式
  post
• 请求参数

[
    {
        rules: [...]
    },
    {
        your_castle: "",
        computer_castle: [...]
    },
    {
        your_choice: "自己的落子",
        computer_choice: "..."
    },
    {
        key: ...
    }
]

• 请求参数解释
  与上述相同，在此不多做赘述。

• 返回参数

  • 图片1
  • 图片2
  • JSON文件
    

    [
    {
        rules: [...]
    },
    {
        your_castle: "",
        computer_castle: [...]
    },
    {
        your_choice: "...",
        computer_choice: "电脑本局的落子"
    },
    {
        key: ...
    }
    ]

• 返回参数解释

  • 图片1:返回由你落子之后的棋盘状态。
  • 图片2:返回由电脑落子之后的棋盘状态。
  • JSON文件：与上述相同。