REST API · v1

API предметов DayZ

Вся база предметов в формате JSON, бесплатно с личным ключом API. Для ботов Discord, серверных инструментов, оверлеев и ваших собственных проектов.

DZPage в Claude, Codex и других ИИ-ассистентахMCP-сервер

У DZPage есть MCP-сервер (Model Context Protocol). Подключи его один раз, и твой ИИ-ассистент будет сам заглядывать на DZPage, пока помогает тебе: характеристики предметов, лут, заражённые, список серверов и обновления игры. Он также может проверить файлы и логи твоего сервера. Ни аккаунт, ни API-ключ не нужны.

Адрес сервера

https://dzpage.com/mcp

Claude (веб-версия и приложение для компьютера)

Открой настройки, перейди в Connectors и добавь собственный коннектор: в качестве имени DZPage, в качестве URL адрес сервера выше.

Claude Code

Выполни это один раз в терминале:

claude mcp add --transport http dzpage https://dzpage.com/mcp

Codex (CLI и расширение для IDE)

Выполни это один раз или добавь блок в ~/.codex/config.toml:

codex mcp add dzpage --url https://dzpage.com/mcp

# ~/.codex/config.toml
[mcp_servers.dzpage]
url = "https://dzpage.com/mcp"

Cursor и VS Code

Один клик открывает приложение на компьютере, и оно спросит, прежде чем добавить DZPage. Если ничего не происходит, используй конфигурацию ниже.

Добавить в Cursor Установить в VS Code

Другие клиенты

Подойдёт любой клиент, который поддерживает удалённые MCP-серверы через Streamable HTTP. В 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 для задачи

Спроси, например

Сколько попаданий нужно из АКМ на 200 м по игроку в бронежилете?
Почему падает мой сервер? Вот лог RPT.
Что изменило последнее обновление DayZ в types.xml на Чернаруси?

Бесплатно и только для чтения, до 120 запросов в минуту с одного IP-адреса, из них не более 6 проверок файлов или логов. Файлы и логи, которые присылает твой ассистент, только проверяются и не сохраняются.

Доступ и добросовестное использование

Все конечные точки /api/v1 требуют бесплатного ключа API: он защищает от злоупотреблений и делает возможными честные лимиты запросов. Ключ ничего не стоит.

Войдите через Discord. Сам аккаунт бесплатный.
Создайте бесплатный ключ API в настройках.
Создайте ключ 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, обновляются после игровых патчей.

GET`/api/v1/items`

Поиск и фильтрация предметов (с постраничной разбивкой)

Параметр	Описание
q	Поиск по названию и имени класса (нечёткий)
cat	Категория, например Weapon, Food / Drink, Ammo
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=ru"

{
  "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/ru/items/akm"
    }
  ]
}

GET`/api/v1/items/{class_name}`

Один предмет со всеми деталями

Принимает имена классов (без учёта регистра) или слаги. Возвращает все поля: характеристики оружия, боеприпасы, магазины, обвесы, данные лута, здания спавна, рецепты, все локализованные названия и полные исходные данные конфига.

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/items/AKM?lang=ru"

// 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.ru, item.weapon_stats.rpm_full_auto);

GET`/api/v1/categories`

Все категории с количеством предметов

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/categories"

GET`/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"
}

Статус · код	Значение
401 · missing_api_key	Ключ API не отправлен. Добавьте заголовок «Authorization: Bearer» или «X-Api-Key».
401 · invalid_api_key	Ключ не существует или был отозван.
404 · not_found	Нет предмета с таким именем класса или слагом.
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)

Основные правила

Один ключ покрывает ваши собственные проекты, ботов и серверные инструменты при добросовестном использовании в пределах лимита запросов.
Если вы используете это в своих проектах, будем признательны за ссылку на dzpage.com.
Иконки предметов (URL-адреса icon / icon_thumb) можно свободно встраивать по прямым ссылкам: они кэшируются надолго и не требуют ключа.
Этот API имеет версию v1: поля могут добавляться, но существующие поля не будут удаляться или переименовываться.

Загрузка …

Готовим инструмент

DZPage в Claude, Codex и других ИИ-ассистентахMCP-сервер

Claude (веб-версия и приложение для компьютера)

Claude Code

Codex (CLI и расширение для IDE)

Cursor и VS Code

Другие клиенты

Что твой ассистент сможет с его помощью

Спроси, например

Доступ и добросовестное использование

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Ошибки, лимиты и стабильность

Основные правила

DZPage в Claude, Codex и других ИИ-ассистентахMCP-сервер

Claude (веб-версия и приложение для компьютера)

Claude Code

Codex (CLI и расширение для IDE)

Cursor и VS Code

Другие клиенты

Что твой ассистент сможет с его помощью

Спроси, например

Доступ и добросовестное использование

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Ошибки, лимиты и стабильность

Основные правила

GET`/api/v1/items`

GET`/api/v1/items/{class_name}`

GET`/api/v1/categories`

GET`/api/v1/meta`

GET`/api/v1/items`

GET`/api/v1/items/{class_name}`

GET`/api/v1/categories`

GET`/api/v1/meta`