首页 > 代码库 > 【官方文档】《暗黑世界V1.4》API说明！

【官方文档】《暗黑世界V1.4》API说明！

2024-07-16 18:27:29   217人阅读

指令号说明
账号注册   100
{
username   str     用户名
password   str     密码
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
}
 
账号登陆   101
请求信息
{
username   str     用户名
password   str     密码
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
userId         int     用户ID
hasRole        bool    是否创建了角色
characterId    int     用户的角色ID
      }
}
创建角色   102
请求信息
{
rolename   str     角色的名称
profession int     角色的职业类型
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
characterId    int     用户的角色ID
     }
}
角色登陆   103
请求信息
{
characterId    int     角色的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
cid    int     角色ID
name       str    角色的名称
level          int     角色的等级
exp            int     角色的当前经验值
maxexp         int     角色的最大经验值
yuanbao            int     黄金的数量
coin           int     银子的数量
power          int     当前体力值（最大值一样）
gas            int     当前活力值(最大为30)
profession     int     角色的职业  
}
}
 
角色状态栏信息 105
请求信息
{
characterId    int     角色的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
characterId    int     角色ID
rolename       str    角色的名称
level          int     角色的等级
exp            int     角色的当前经验值
maxexp         int     角色的最大经验值
gold           int     黄金的数量
coin           int     银子的数量
tili           int     当前体力值
tilimax        int     最大体力值
huoli          int     当前活力值
maxhuoli       int     最大活力值
viplevel       int     vip等级
profession     int     角色的职业  
}
}
 
战役信息   4500
请求信息
{
characterId    int     用户的角色ID
index          index   当前地图在屏数的ID（初始时设置为0）
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
     cityid     int     地图的id
     citylist[
       pj       int     通关的评级（0,1,2,3星）
      }
  }
}
 
 
战役战斗   4501
{
characterId    str     用户的角色ID
zjid           int     怪物的id
}
返回信息
{
result     bool    指令调用是否成功                                上方
  
7
  		  
8
  		  
9
  
  
4
  		  
5
  		  
6
  
  
1
  		  
2
  		  
3
  
message    str     指令调用返回的信息
data{
battleResult   int     战斗结果 1胜利 2失败
 
setData{               战斗结算数据
star           int     战斗评价
huoli          int     活力消耗
exp            int     威望
coin           int     战斗获得的银两                              下方
  
1
  		  
2
  		  
3
  
  
4
  		  
5
  		  
6
  
  
7
  		  
8
  		  
9
  
item[
{ itemid    int     物品的ID物品的唯一标示
  icon      int     物品的图标信息
  tempid    int     物品的模板id（物品的类型）
}]}
 
startData[             战斗初始化信息
{chaId         int     角色的id
  chaBattleId   int     角色的战场id（唯一标示）
  chaName       int     角色的名称
  chaLevel      int     角色的等级
  chaDirection  int     角色的阵营 1下方 2上方
  chaCurrentHp  int     角色的当前血量
  chaTotalHp    int     角色的最大血量
  chaPos        int     角色的阵法位置
  chaIcon       int     角色的头像ID
  difficulty    int     角色的品质
  chaCurrentPower int   角色的当前能量
  },
stepData[              战斗回合数据
{chaBattleId   int     攻击方的战场ID
  chaExpendHp   int     攻击方的血量变化
  chaId         int     攻击方的ID
  actionId      int     攻击方的攻击动作ID
  chaCurrendHp  int     攻击方的当前血量
  chaTotalHp    int     攻击方的最大血量
  skill         int     攻击方所用的技能的ID
  chaCurrentPower int   攻击方的当前能量
  chaBuffArr    list[int] 攻击方的当前能量
  enemyChaArr[          受攻击方的人的信息
      {enemyBattleId    int 角色的战场ID
       enemyChaId       int 角色的ID
       enemyActionId    int 角色的受攻击动作
       enemyChangeHp    int 角色的血量变化
       enemyCurrentHp   int 角色的当前血量
       enemyTotalHp     int 角色的总血量
       enemyTxtEffectId int     攻击方的文字特效  9996暴击
       enemyCurrentPower int    攻击方的当前能量
       enemyBuffArr list[int] 攻击方的当前能量
 
 
  } ,
 
}
}
 
 
获取好友排行   302
请求信息
{
characterId    str     用户的角色ID
tag            int     标签的标示 1过关排行 2等级排行 3全服排行
index          int     好友的起始排名号
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
  end       int     当前好友列表的结束排名
  friendlist[
  {rolename str     角色的名称
   level    int     角色的等级
   skill    str     技能的名称
   price    int     角色的身价
   rank     int     角色的排名
  }
}
 
获取单个角色的信息 221
{
characterId    str     用户的角色ID
type           int     角色的类型 1角色自身 2好友 3宠物
tid            int     对象角色的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
  chaid     int     角色的ID
  rolename  str     角色的名称
  icon      str     角色的头像ID
  level     int     角色的等级
  skill     str     角色的技能名称
  guanqia   str     角色所在的关卡的名称
  attack    int    角色的伤害值
  fangyu    int     角色的额防御值
  tili      int     角色的体力值
  minjie    int     角色的敏捷值
  price     int     角色的身价
  }
}
 
获取角色的阵法信息 2306
{
characterId    str     用户的角色ID
}                                                              阵法位置示意图
返回信息
  
1
  		  
2
  		  
3
  
  
4
  		  
5
  		  
6
  
  
7
  		  
8
  		  
9
  
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{matrix[
  {pos      int     阵法的位置
   chaid    int     角色的id
   chatype  int     角色的类型  1角色自身 2好友 3宠物
   tempid   int     角色的图标ID
  },]}
  }
}
 
获取可以上阵角色列表  2300
{
characterId    str     用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
  petlist[
  {chaid    int     角色的id
   chatype  int     角色的类型  1角色自身 2好友 3宠物
   tempid   int     角色的图标ID
  },
}
 
 

本帖隐藏的内容

获取单个物品的信息 211
{
characterId    str     用户的角色ID
itemid         int     物品的id（唯一标示）
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
   itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   itemname str     物品的名称
   itemdesc str     物品的描述
   tempid   int     物品的模板id（物品的类型）
   qlevel   int     物品的强化等级
   attack   int     物品的伤害值
   fangyu   int     物品的防御值
   tili     int     物品的体力增加
   minjie   int     物品的敏捷附加
   price    int     物品的价格
   stack    int     物品的堆叠数
   qh       bool    是否能强化
}
}
 
获取合成界面包裹的信息 2109
{
characterId    str     用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
  itemlist[
  {itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   stack    int     物品的数量
   tempid   int     物品的模板id（物品的类型）
}
}
 
获取能合成的物品的信息 205
{
characterId    str     用户的角色ID
tempid         int     物品的模版ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
  hcprice   int     物品合成的价格
  iteminfo{
   itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   itemname str     物品的名称
   itemdesc str     物品的描述
   tempid   int     物品的模板id（物品的类型）
   qlevel   int     物品的强化等级
   attack   int     物品的伤害值
   fangyu   int     物品的防御值
   tili     int     物品的体力增加
   minjie   int     物品的敏捷附加
   price    int     物品的价格
   stack    int     物品的堆叠数
   qh       bool    是否能强化
  }
}
 
合成物品       2116
{
characterId    str     用户的角色ID
tempid         int     物品的模版ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data               返回合成包裹中物品的信息
{
  itemlist[
  {itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   stack    int     物品的数量
   tempid   int     物品的模板id（物品的类型）
}
}
 
个人装备栏信息 203
{
characterId    str     用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
  
1
  		  
 
  		  
4
  
  
2
  		  
5
  
  
3
  		  
6
  
{
  attack    int     角色的伤害值
  fangyu    int     角色的防御值
  minjie    int     角色的敏捷值
  equip[
  {pos      int     装备的位置
   item{            装备的信息
   itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   tempid   int     物品的模板id（物品的类型）      
       }
   },
}
}
 
获取包裹的信息 204   
{
characterId    str     用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data               返回包裹中物品的信息
{
  itemlist[
  {itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   stack    int     物品的数量
   tempid   int     物品的模板id（物品的类型）
}
}
 
强化装备   2102
{
characterId    str     用户的角色ID
itemId         int     物品的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data           
{
   iteminfo{        返回物品强化后的信息
   itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   itemname str     物品的名称
   itemdesc str     物品的描述
   tempid   int     物品的模板id（物品的类型）
   qlevel   int     物品的强化等级
   attack   int     物品的伤害值
   fangyu   int     物品的防御值
   tili     int     物品的体力增加
   minjie   int     物品的敏捷附加
   price    int     物品的价格
   stack    int     物品的堆叠数
   qh       bool    是否能强化
  }
}
 
使用物品、装备装备 210
{
characterId    str     用户的角色ID
tempid         int     物品的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data               返回包裹中物品的信息
{
  itemlist[
  {itemid   int     物品的ID物品的唯一标示
   icon     int     物品的图标信息
   tempid   int     物品的模板id（物品的类型）
  }
}
设置阵法   2307
{
characterId    str     用户的角色ID
petId          int     宠物的ID
chatype        int     角色的类型 1角色自身 2好友 3宠物
operType       int     操作类型 0宠物列表到阵法1阵法到宠物列表2阵法到阵法
fromPos        int     起始位置
toPos          int     结束位置
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
}
雇佣好友   2301
{
characterId    str     用户的角色ID
friendid           int     好友的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
}
 
获取雇用记录   2309
{
characterId    str     用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
recordlist[
{datestr   str     雇用的时间
  rolename  str     好友的名称
  zyname    str     关卡的名称
  bresult   str     胜利或失败
  coin      int     赚取的钱
  huoli     int     获得的活力
  },
}
}
物品吞噬   212
{
characterId    str     用户的角色ID
itemid         int     吞噬物品的ID
toitemid       int     被吞噬的物品的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
  }
}
卸下装备   215
{
characterId    str     用户的角色ID
itemid         int     卸下的装备的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
}
获取将要强化的物品信息 2117
{
characterId    str     用户的角色ID
itemid         int     卸下的装备的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data
{
  itemId    int     物品的ID
  strEff    str     被强化的属性信息  （伤害，防御等）
  effValue  int     强化的效果值    （+14）
  reqCoin   int     强化需要消耗的钱数
  qhlevel   int     物品的强化等级
}
}
获取公告信息      1002
{
characterId    str     用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
data{
msglist[]  str     公告列表    30秒获取一次
}
}
武将吞噬 3505
{
characterId    str     用户的角色ID
petid          int     武将的ID
tpetid         int     被吞噬的武将的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str     指令调用返回的信息
}
 
 
获取邮件列表   501
{
characterId    int  用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str  指令调用返回的信息
data{
  maillist[
  {id    int    邮件的id
   title    str  邮件的标题
   sender   str  发送者的名称
   isReaded int  是否阅读 0未读 1已读
   sendTime str  邮件发送时间
   }
  ]
}
}
 
获取（阅读）邮件内容  505
{
characterId    int  用户的角色ID
mailID  int     邮件的ID
}
返回信息
{
result     bool    指令调用是否成功
message    str  指令调用返回的信息
data{
id  int     邮件的id
title  str  邮件的标题
sender str  发送者的名称
isReaded   是否阅读 0未读 1已读
sendTime   str  邮件发送时间
content    str  邮件的内容
}
}
 
发送邮件   502
{
characterId    int  用户的角色ID
pname   str     对方的名称
title   str     邮件标题
content     str    邮件内容
}
返回信息
{
result     bool    指令调用是否成功
message    str  指令调用返回的信息
}
 
获取竞技场信息 3700
{
characterId    int  用户的角色ID
}
返回信息
{
result     bool    指令调用是否成功
message    str  指令调用返回的信息
data
{
  ranking   int  当前排名
  sptimes   int    剩余次数
  dsList            对手列表
  [{
    characterId     int  对手的id
    nickname     int    对手的名称
    level    int    对手的等级
    profession   int     对手的职业
    ranking  int     对手的排名
   }
}
}
 
竞技场战斗 3704
{
characterId    int  用户的角色ID
tid     int    对手的id
}
返回信息
{
result     bool    指令调用是否成功
message    str  指令调用返回的信息
data       和普通战斗消息一致
}


联系
我们