加载中 …
正在准备工具
Cookie 与隐私
我们只使用三个技术上必需的 Cookie（登录、语言、你的 Cookie 选择）。Google AdSense 广告仅在你同意后才会加载——它帮助分担服务器成本。你可以随时通过页脚的“Cookie 设置”更改你的选择。 隐私政策
REST API · v1
完整的物品数据库以 JSON 提供 – 用个人 API 密钥即可免费使用。适合 Discord 机器人、服务器工具、游戏内叠加界面和你自己的项目。
所有 /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)