加载中 …
正在准备工具
加载中 …
正在准备工具
Cookie 与隐私
我们只使用三个技术上必需的 Cookie(登录、语言、你的 Cookie 选择)。Google AdSense 广告仅在你同意后才会加载,它帮助分担服务器成本。你可以随时通过页脚的“Cookie 设置”更改你的选择。 隐私政策
REST API · v1
完整的物品数据库以 JSON 提供,用个人 API 密钥即可免费使用。适合 Discord 机器人、服务器工具、游戏内叠加界面和你自己的项目。
DZPage 提供一个 MCP 服务器(Model Context Protocol)。只需连接一次,你的 AI 助手在帮助你时就会自己去 DZPage 查找信息:物品属性、物资、感染者、服务器列表和游戏更新。它还可以检查你的服务器文件和日志。无需账号,也无需 API 密钥。
服务器地址
https://dzpage.com/mcp打开设置,进入 Connectors,添加一个自定义连接器:名称填 DZPage,URL 填上面的服务器地址。
在终端中运行一次:
claude mcp add --transport http dzpage https://dzpage.com/mcp运行一次,或者把这段配置加入 ~/.codex/config.toml:
codex mcp add dzpage --url https://dzpage.com/mcp
# ~/.codex/config.toml
[mcp_servers.dzpage]
url = "https://dzpage.com/mcp"任何支持通过 Streamable HTTP 连接远程 MCP 服务器的客户端都可以使用。JSON 配置如下:
{
"mcpServers": {
"dzpage": {
"type": "http",
"url": "https://dzpage.com/mcp"
}
}
}search_items用任意语言按名称搜索物品数据库get_item物品的全部数值:重量、尺寸、武器属性、弹匣、配件、物资等级以及刷新建筑where_to_find_item物品在地图上的刷新位置:匹配建筑最多的地点,附带坐标和物资地图链接compare_weapons比较枪械:不同距离的伤害,以及有无背心时击杀所需的命中次数get_infected每种感染者的生命值、命中部位、攻击和掉落概率search_servers查找 PC、PlayStation 和 Xbox 的社区服务器及实时玩家人数dayz_update_changes每次 DayZ 更新对 types.xml、events.xml 和其他原版文件做了哪些修改day_night_settings把你想要的白天和黑夜时长换算成 serverDZ.cfg 中的数值explain_server_setting解释 globals.xml 或 cfggameplay.json 中的设置:含义、原版数值、取值范围和对应的编辑器validate_config_file一次找出 XML 或 JSON 服务器文件中的所有语法错误analyze_server_log解释服务器日志中的问题以及解决方法find_tool为某项任务推荐合适的 DZPage 工具免费且只读,每个 IP 地址每分钟最多 120 次请求,其中文件或日志检查最多 6 次。你的助手发送的文件和日志只会被检查,不会被保存。
所有 /api/v1 接口都需要一个免费的 API 密钥,它既能防止滥用,也能实现公平的频率限制。密钥完全免费。
# Empfohlen / recommended
curl -H "Authorization: Bearer dzp_YOUR_KEY" \
"https://dzpage.com/api/v1/items?q=akm"
# Alternative
curl -H "X-Api-Key: dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"请妥善保管密钥:只从你的服务器、机器人或后端调用 API。任何拿到密钥的人都会消耗你的配额。你可以随时在设置里吊销密钥并新建一个,旧密钥会立即失效。
游戏数据对所有人免费开放,今后也会一直如此。API 免费,并且永远免费。DayZ 及其游戏数据归 Bohemia Interactive a.s. 所有。
管理 API 密钥需要 API 密钥
每个请求都要通过 "Authorization: Bearer" 或 "X-Api-Key" 请求头发送密钥。
60 → 300 次请求/分钟
每个密钥每分钟 60 次请求。每个响应都会带上 X-RateLimit 系列响应头。
真实游戏数据
直接从 DayZ 的配置文件中提取,游戏更新后同步更新。
/api/v1/items搜索并筛选物品(分页)
| 参数 | 说明 |
|---|---|
| q | 在名称和类名中搜索(模糊匹配) |
| cat | 分类,例如 Weapon、Food / Drink、Ammo |
| tier | 物资等级(tier):Tier1 至 Tier4 或 Unique |
| sort | name(默认)、damage、rpm 或 weight |
| page | 页码,从 1 开始 |
| limit | 每页结果数,1 至 100(默认 48) |
| icons | 1 = 只返回有图标的物品 |
| lang | name 字段的语言:en, de, fr, es, it, ru, pl, cs, pt, zh(默认 en) |
curl -H "Authorization: Bearer dzp_YOUR_KEY" \
"https://dzpage.com/api/v1/items?q=akm&limit=5&lang=zh"{
"meta": { "total": 12, "page": 1, "pages": 3, "limit": 5 },
"items": [
{
"class_name": "AKM",
"slug": "akm",
"name": "KA-M",
"category": "Weapon",
"has_icon": true,
"weight": 2140,
"size_w": 8, "size_h": 3,
"loot_tiers": ["Tier4"],
"damage": 9.5,
"icon": "https://dzpage.com/icons/full/AKM.png",
"icon_thumb": "https://dzpage.com/icons/thumb/AKM.webp",
"url": "https://dzpage.com/zh/items/akm"
}
]
}/api/v1/items/{class_name}单个物品的全部详情
接受类名(不区分大小写)或 slug。返回全部字段:武器数据、弹药、弹匣、配件、物资数据、刷新建筑、制作配方、所有语言的名称以及完整的原始配置数据。
curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/items/AKM?lang=zh"// JavaScript (Node.js, Discord-Bot, …)
const res = await fetch("https://dzpage.com/api/v1/items/AKM", {
headers: { Authorization: "Bearer " + process.env.DZPAGE_API_KEY },
});
const { item } = await res.json();
console.log(item.names.zh, item.weapon_stats.rpm_full_auto);/api/v1/categories全部分类及物品数量
curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/categories"/api/v1/meta数据集信息:导入日期、物品数量、游戏版本号
curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"错误始终以 JSON 返回,包含稳定的错误码、便于阅读的说明和文档链接:
{
"error": "invalid_api_key",
"message": "Invalid or revoked API key. …",
"docs": "https://dzpage.com/api"
}| 状态码 · code | 含义 |
|---|---|
| 401 · missing_api_key | 未发送 API 密钥。请加上 "Authorization: Bearer" 或 "X-Api-Key" 请求头。 |
| 401 · invalid_api_key | 该密钥不存在或已被吊销。 |
| 404 · not_found | 没有匹配该类名或 slug 的物品。 |
| 429 · rate_limited | 频率限制已用尽,请等待 Retry-After 指定的秒数后重试。 |
| 5xx | 服务器错误,可以放心重试。如果一直出现,请到我们的 Discord 反馈。 |
每个成功的响应都会带上频率限制响应头,方便你的客户端自行控制节奏:
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1789000000
Retry-After: 31 (nur bei 429 / only on 429)