《暗黑世界V1.4》API说明文档

《暗黑世界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 和普通战斗消息一致

}