AxibugEmuOnline/README_WEBAPI.md

4.5 KiB
Raw Blame History

接口说明

这里说明WebApi类的接口

基本信息检查

{WebHost}/api/NesRomList?platform=<平台编号>&version=<版本>

Request:

http://emu.axibug.com/api/CheckStandInfo?platform=1&version=1.0.0.0

Response:

{
    "needUpdateClient": 0,
    "serverIp": "139.186.160.243",
    "serverPort": 10492,
    "clientVersion": "0.0.0.1",
    "downLoadUrl": ""
}

序列化C#实体类示例

class Resp_CheckStandInfo
{
    public int needUpdateClient { get; set; }
    public string serverIp { get; set; }
    public ushort serverPort { get; set; }
    public string clientVersion { get; set; }
    public string downLoadUrl { get; set; }
}

Nes游戏列表

{WebHost}/api/NesRomList?Page=<页码>&PageSize=<单大小>&SearchKey=<可选的模糊查询关键字>&PType=<平台枚举int>&GType=<游戏类型枚举>

Request:

http://emu.axibug.com/api/NesRomList?Page=0&PageSize=5&SearchKey=%热血&PType=1&GType=1

Response:

{
    "page": 0,
    "maxPage": 2,
    "resultAllCount": 6,
    "gameList": [
        {
            "orderid": 0,
            "id": 190,
            "romName": "热血物语",
            "gType": "ACT",
            "desc": "设有拳击及体力槽的热血系列节目。是带有RPG色彩的街头斗殴节目。",
            "url": "roms/fcrom/Downtown%20-%20Nekketsu%20Monogatari%20(J).zip",
            "imgUrl": "images/fcrom/Downtown%20-%20Nekketsu%20Monogatari%20(J).JPG",
            "hash": "",
            "stars": 0
        },
        {
            "orderid": 1,
            "id": 460,
            "romName": "热血时代剧(热血道中记)",
            "gType": "ACT",
            "desc": "以古代日本为舞台展开的热血系列节目。设有多种必杀技可使用。",
            "url": "roms/fcrom/Kunio%20Kun%20No%20Jidaigekidayo%20Zenin%20Shuugou%20(J).zip",
            "imgUrl": "images/fcrom/Kunio%20Kun%20No%20Jidaigekidayo%20Zenin%20Shuugou%20(J).JPG",
            "hash": "",
            "stars": 0
        },
        {
            "orderid": 2,
            "id": 585,
            "romName": "热血硬派",
            "gType": "ACT",
            "desc": "有着多种模式的格斗节目。各版面均有不同的趣味性。是热血系列游戏最初的作品。",
            "url": "roms/fcrom/Nekketsu%20Kouha%20-%20Kunio%20Kun%20(J).zip",
            "imgUrl": "images/fcrom/Nekketsu%20Kouha%20-%20Kunio%20Kun%20(J).JPG",
            "hash": "",
            "stars": 0
        },
        {
            "orderid": 3,
            "id": 674,
            "romName": "热血物语(美版)",
            "gType": "ACT",
            "desc": "设有拳击及体力槽的热血系列节目。是带有RPG色彩的街头斗殴节目。",
            "url": "roms/fcrom/River%20City%20Brawl%20(J).zip",
            "imgUrl": "images/fcrom/River%20City%20Brawl%20(J).JPG",
            "hash": "",
            "stars": 0
        },
        {
            "orderid": 4,
            "id": 826,
            "romName": "热血时代剧美版(热血道中记美版)",
            "gType": "ACT",
            "desc": "以古代日本为舞台展开的热血系列节目。设有多种必杀技可使用。",
            "url": "roms/fcrom/Technos%20Samurai%20-%20Downtown%20Special%20(J).zip",
            "imgUrl": "images/fcrom/Technos%20Samurai%20-%20Downtown%20Special%20(J).JPG",
            "hash": "",
            "stars": 0
        }
    ]
}

序列化C#实体类示例

      enum PlatformType : byte
      {
          All = 0,
          Nes,
      }

      enum GameType : byte
      {
          NONE = 0,
          ACT,
          ARPG,
          AVG,
          ETC,
          FTG,
          PUZ,
          RAC,
          RPG,
          SLG,
          SPG,
          SRPG,
          STG,
          TAB,
          /// <summary>
          /// 合卡
          /// </summary>
          ALLINONE,
      }

      class Resp_GameList
      {
          public int page { get; set; }
          public int maxPage { get; set; }
          public int resultAllCount { get; set; }
          public List<Resp_RomInfo> gameList { get; set; }
      }

      public class Resp_RomInfo
      {
          public int orderid { get; set; }
          public int id { get; set; }
          public string romName { get; set;}
          public string gType { get; set; }
          public string desc { get; set; }
          public string url { get; set; }
          public string imgUrl { get; set; }
          public string hash { get; set; }
          public int stars { get; set; }
      }