《暗黑世界V1.4》API说明文档
阵法位置示意图
上方： 下方：
账号注册 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 指令调用是否成功
message str 指令调用返回的信息
data{
battleResult int 战斗结果 1胜利 2失败
setData{ 战斗结算数据
star int 战斗评价
huoli int 活力消耗
exp int 威望
coin int 战斗获得的银两
item[
{ itemid int 物品的ID物品的唯一标示
icon int 物品的图标信息
tempid int 物品的模板id（物品的类型）
}]}
startData[ 战斗初始化信息
{chaId int 角色的id
chaBattleId int 角色的战场id（唯一标示）
chaName int 角色的名称
chaLevel int 角色的等级
chaCurrentHp int 角色的当前血量
chaTotalHp int 角色的最大血量
chaDirection int 角色的阵营 1下方 2上方
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
}
返回信息
{
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
{
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 和普通战斗消息一致
}