倾梦仙侠接口文档

功能完成清单

✓ 大区创建与管理（含密码验证）
✓ 10个仙侠角色模板系统
✓ 角色创建（支持QQ和名称参数）
✓ 签到系统（含连续签到奖励）
✓ 修炼系统（含冷却时间和奇遇）
✓ 角色查询功能
✓ 背包系统（使用/丢弃物品）
✓ 挖宝系统（3小时冷却）
✓ 随机PK系统（含境界压制机制）
✓ 商店系统（300个商品）
✓ 角色血量与复活系统
✓ 装备系统（30个装备）
✓ 货币系统（灵石/仙晶兑换）
✓ 银行系统（存取款和利息）
✓ 奇遇系统（4小时冷却）
✓ 礼包系统（境界礼包/新手礼包）
✓ 任务系统（每日任务）

基础信息

基础请求路径：https://api.317ak.cn/api/qmxianxia

所有接口请求都需要以下基础参数：

参数名	类型	必填	说明
ckey	string	是	付费访问密钥
region	string	是	大区名称
password	string	是	大区密码
qq	string	是	玩家QQ号
msg	string	是	操作指令

大区管理

创建大区

https://api.317ak.cn/api/qmxianxia?msg=创建大区&region_name=测试大区&ckey=您的密钥

{
  "code": 200,
  "message": "倾梦仙侠大区创建测试大区成功",
  "data": {
    "region": "测试大区",
    "password": "xYz123AbCdEf"
  }
}

角色系统

创建角色

https://api.317ak.cn/api/qmxianxia?msg=创建角色&qq=123456&region=测试大区&password=xYz123AbCdEf&name=逍遥子&ckey=您的密钥

{
  "code": 200,
  "message": "角色创建成功",
  "data": {
    "name": "逍遥子",
    "sect": "丹宗",
    "stats": {
      "hp": 100,
      "attack": 15,
      "defense": 10,
      "cultivation": "炼气初期"
    }
  }
}

查询角色

https://api.317ak.cn/api/qmxianxia?msg=查询角色&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "data": {
    "name": "逍遥子",
    "sect": "丹宗",
    "stats": {
      "hp": 100,
      "attack": 15,
      "defense": 10,
      "cultivation": "炼气初期"
    },
    "equipment": {
      "weapon": "青锋剑",
      "armor": "软猬甲",
      "accessory": null
    },
    "sign_in_days": 5,
    "last_cultivation": "2023-08-15 14:30:00"
  }
}

游戏功能

签到

https://api.317ak.cn/api/qmxianxia?msg=签到&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "message": "签到成功！连续签到6天",
  "rewards": [
    "获得 下品灵石 x50",
    "获得 气血丹 x3",
    "获得 周签到礼包 x1"
  ]
}

修炼

https://api.317ak.cn/api/qmxianxia?msg=修炼&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "message": "修炼完成！",
  "gains": [
    "cultivation_exp +15",
    "hp +5",
    "attack +2",
    "奇遇：发现一处灵气充沛的宝地，修炼效果翻倍"
  ]
}

挖宝

https://api.317ak.cn/api/qmxianxia?msg=挖宝&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "message": "挖宝成功！",
  "rewards": [
    "获得 下品灵石 x80",
    "获得 神秘宝箱 x1"
  ]
}

随机PK

https://api.317ak.cn/api/qmxianxia?msg=随机PK&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "message": "PK结果：\n你(逍遥子) vs 林逸\n你的境界：筑基中期\n对手境界：炼气后期",
  "result": "你以绝对实力碾压对手，一招将其击败！"
}

触发奇遇

https://api.317ak.cn/api/qmxianxia?msg=触发奇遇&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "message": "奇遇触发成功",
  "event": "你在秘境中发现了一处上古遗迹",
  "rewards": [
    "获得 上古功法 x1",
    "获得 上品灵石 x5"
  ]
}

背包与装备系统

查看背包

https://api.317ak.cn/api/qmxianxia?msg=背包&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "items": {
    "下品灵石": 150,
    "气血丹": 5,
    "筑基丹": 2,
    "神秘宝箱": 1
  }
}

使用物品

https://api.317ak.cn/api/qmxianxia?msg=使用物品&qq=123456&region=测试大区&password=xYz123AbCdEf&item=气血丹&quantity=1&ckey=您的密钥

{
  "code": 200,
  "message": "使用 气血丹 x1 成功",
  "effects": [
    "hp +20"
  ]
}

装备物品

https://api.317ak.cn/api/qmxianxia?msg=装备&qq=123456&region=测试大区&password=xYz123AbCdEf&item=青锋剑&ckey=您的密钥

{
  "code": 200,
  "message": "成功装备 青锋剑",
  "stats_change": {
    "attack": "+10"
  }
}

商店与银行系统

查看商店

https://api.317ak.cn/api/qmxianxia?msg=商店列表&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "items": [
    {
      "name": "气血丹",
      "price": 50,
      "currency": "下品灵石",
      "stock": 100
    },
    {
      "name": "筑基丹",
      "price": 200,
      "currency": "下品灵石",
      "stock": 50
    },
    {
      "name": "玄铁重剑",
      "price": 500,
      "currency": "下品灵石",
      "stock": 10
    }
  ]
}

购买物品

https://api.317ak.cn/api/qmxianxia?msg=购买&qq=123456&region=测试大区&password=xYz123AbCdEf&item=气血丹&quantity=2&ckey=您的密钥

{
  "code": 200,
  "message": "购买成功！获得 气血丹 x2，花费 100下品灵石"
}

银行操作

https://api.317ak.cn/api/qmxianxia?msg=银行&qq=123456&region=测试大区&password=xYz123AbCdEf&operation=存入&type=灵石&amount=100&ckey=您的密钥

{
  "code": 200,
  "message": "成功存入 100灵石",
  "balance": {
    "bank_spirit_stones": 100,
    "spirit_stones": 50
  }
}

礼包与任务系统

领取礼包

https://api.317ak.cn/api/qmxianxia?msg=领取礼包&qq=123456&region=测试大区&password=xYz123AbCdEf&type=新人礼包&ckey=您的密钥

{
  "code": 200,
  "message": "成功领取 新人礼包",
  "rewards": [
    "获得 下品灵石 x100",
    "获得 气血丹 x5",
    "获得 筑基丹 x1"
  ]
}

查看任务

https://api.317ak.cn/api/qmxianxia?msg=任务列表&qq=123456&region=测试大区&password=xYz123AbCdEf&ckey=您的密钥

{
  "code": 200,
  "tasks": [
    {
      "name": "每日签到",
      "completed": true,
      "reward": "下品灵石 x50"
    },
    {
      "name": "修炼一次",
      "completed": false,
      "reward": "修炼经验 x20"
    },
    {
      "name": "完成一次挖宝",
      "completed": false,
      "reward": "随机宝物 x1"
    }
  ]
}