API REST · v1

API de Itens do DayZ

Todo o banco de dados de itens em JSON, de uso gratuito com uma chave de API pessoal. Para bots do Discord, ferramentas de servidor, overlays e seus próprios projetos.

Use o DZPage no Claude, no Codex e em outros assistentes de IAServidor MCP

O DZPage oferece um servidor MCP (Model Context Protocol). Conecte-o uma vez e o seu assistente de IA consulta o DZPage sozinho enquanto ajuda você: atributos de itens, loot, infectados, a lista de servidores e as atualizações do jogo. Ele também pode verificar os arquivos e logs do seu servidor. Não precisa de conta nem de chave de API.

Endereço do servidor

https://dzpage.com/mcp

Claude (web e aplicativo para desktop)

Abra as configurações, vá até Connectors e adicione um conector personalizado: DZPage como nome e o endereço do servidor acima como URL.

Claude Code

Execute isto uma vez no terminal:

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

Codex (CLI e extensão para IDE)

Execute isto uma vez ou adicione o bloco em ~/.codex/config.toml:

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

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

Cursor e VS Code

Um clique abre o app no seu computador, que pergunta antes de adicionar o DZPage. Se nada acontecer, use a configuração abaixo.

Adicionar ao Cursor Instalar no VS Code

Outros clientes

Funciona com qualquer cliente que suporte servidores MCP remotos via Streamable HTTP. Em uma configuração JSON fica assim:

{
  "mcpServers": {
    "dzpage": {
      "type": "http",
      "url": "https://dzpage.com/mcp"
    }
  }
}

O que o seu assistente pode fazer com isso

search_itemsPesquisar o banco de dados de itens pelo nome em qualquer idioma
get_itemTodos os valores de um item: peso, tamanho, atributos de arma, carregadores, acessórios, tiers de loot e construções onde aparece
where_to_find_itemOnde um item aparece em um mapa: os lugares com mais construções compatíveis, com coordenadas e link para o mapa de loot
compare_weaponsComparar armas de fogo: dano à distância e acertos para matar com e sem colete
get_infectedVida, zonas de acerto, ataques e chances de drop de cada infectado
search_serversEncontrar servidores da comunidade para PC, PlayStation e Xbox com o número de jogadores em tempo real
dayz_update_changesO que cada atualização do DayZ mudou no types.xml, no events.xml e nos outros arquivos vanilla
day_night_settingsConverter a duração de dia e noite que você quer nos valores para o serverDZ.cfg
explain_server_settingExplicar uma configuração do globals.xml ou cfggameplay.json: significado, valor vanilla, faixa e o editor certo
validate_config_fileEncontrar de uma vez todos os erros de sintaxe de um arquivo de servidor XML ou JSON
analyze_server_logExplicar os problemas de um log do servidor e como corrigi-los
find_toolIndicar a ferramenta certa do DZPage para uma tarefa

Pergunte, por exemplo

Quantos acertos um AKM precisa a 200 m contra um jogador com colete portaplacas?
Por que o meu servidor está caindo? Aqui está o log RPT.
O que a última atualização do DayZ mudou no types.xml de Chernarus?

Gratuito e somente leitura, até 120 requisições por minuto por endereço IP, das quais até 6 verificações de arquivos ou logs. Os arquivos e logs que o seu assistente envia são apenas verificados, não armazenados.

Acesso e uso justo

Todos os endpoints /api/v1 exigem uma chave de API gratuita: ela evita abusos e torna possíveis limites de requisições justos. A chave não custa nada.

Entre com o Discord. A conta em si é gratuita.
Crie uma chave de API gratuita nas suas configurações.
Crie uma chave de API e envie-a em cada requisição.

# 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"

Mantenha sua chave em segredo: chame a API a partir do seu servidor, bot ou backend. Quem tiver a chave consome sua cota. Você pode revogar uma chave nas configurações a qualquer momento e criar uma nova; a antiga para de funcionar imediatamente.

Os dados do jogo são e continuarão livremente acessíveis para todos. A API é gratuita e continuará assim. DayZ e seus dados de jogo pertencem à Bohemia Interactive a.s.

Gerenciar chaves de API

Chave de API obrigatória

Envie a chave como header "Authorization: Bearer" ou "X-Api-Key" em cada requisição.

60 → 300 requisições/min

60 requisições por minuto por chave. Toda resposta traz headers X-RateLimit.

Dados reais do jogo

Extraídos direto das configs do DayZ, atualizados após os patches do jogo.

GET`/api/v1/items`

Buscar e filtrar itens (paginado)

Parâmetro	Descrição
q	Busca no nome e no nome da classe (fuzzy)
cat	Categoria, ex.: Weapon, Food / Drink, Ammo
tier	Tier de loot: Tier1 a Tier4 ou Unique
sort	name (padrão), damage, rpm ou weight
page	Página, começando em 1
limit	Resultados por página, de 1 a 100 (padrão 48)
icons	1 = apenas itens com ícone
lang	Idioma do campo name: en, de, fr, es, it, ru, pl, cs, pt, zh (padrão en)

curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm&limit=5&lang=pt"

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

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

Item único com todos os detalhes

Aceita nomes de classe (sem diferenciar maiúsculas) ou slugs. Retorna todos os campos: atributos da arma, munição, carregadores, acessórios, dados de loot, construções de spawn, receitas, todos os nomes localizados e os dados brutos completos da config.

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

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

GET`/api/v1/categories`

Todas as categorias com a contagem de itens

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

GET`/api/v1/meta`

Info do dataset: data de importação, contagem de itens, build do jogo

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

Erros, limites e estabilidade

Erros são sempre JSON com um código de erro estável, uma mensagem legível e um link para a documentação:

{
  "error": "invalid_api_key",
  "message": "Invalid or revoked API key. …",
  "docs": "https://dzpage.com/api"
}

Status · código	Significado
401 · missing_api_key	Nenhuma chave de API enviada. Adicione o header "Authorization: Bearer" ou "X-Api-Key".
401 · invalid_api_key	A chave não existe ou foi revogada.
404 · not_found	Nenhum item com esse nome de classe ou slug.
429 · rate_limited	Limite de requisições esgotado. Espere os segundos indicados em Retry-After e tente de novo.
5xx	Erro do servidor: pode tentar de novo sem problema. Se persistir, avise no nosso Discord.

Toda resposta bem-sucedida inclui headers de limite de requisições para que seu cliente possa se autorregular:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1789000000
Retry-After: 31   (nur bei 429 / only on 429)

Regras básicas

Uma chave cobre seus próprios projetos, bots e ferramentas de servidor, com uso justo dentro do limite de requisições.
Se você usar isso nos seus próprios projetos, um link de volta para dzpage.com é bem-vindo.
Os ícones de itens (URLs icon / icon_thumb) continuam livres para hotlink: ficam em cache por muito tempo e não precisam de chave.
Esta API é v1: campos podem ser adicionados, campos existentes não serão removidos nem renomeados.

Carregando …

Preparando a ferramenta

Use o DZPage no Claude, no Codex e em outros assistentes de IAServidor MCP

Claude (web e aplicativo para desktop)

Claude Code

Codex (CLI e extensão para IDE)

Cursor e VS Code

Outros clientes

O que o seu assistente pode fazer com isso

Pergunte, por exemplo

Acesso e uso justo

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Erros, limites e estabilidade

Regras básicas

Use o DZPage no Claude, no Codex e em outros assistentes de IAServidor MCP

Claude (web e aplicativo para desktop)

Claude Code

Codex (CLI e extensão para IDE)

Cursor e VS Code

Outros clientes

O que o seu assistente pode fazer com isso

Pergunte, por exemplo

Acesso e uso justo

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Erros, limites e estabilidade

Regras básicas

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`