API REST · v1

API de objetos DayZ

Toda la base de datos de objetos en JSON – de uso gratuito con una clave API personal. Para bots de Discord, herramientas de servidor, overlays y tus propios proyectos.

Acceso y uso justo

Todos los endpoints /api/v1 requieren una clave API gratuita – evita abusos y hace posibles límites justos. No se necesita suscripción.

Inicia sesión con Discord – la cuenta es gratuita.
Crea una clave API gratuita en tus ajustes.
Crea una clave API y envíala con cada petición.

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

Mantén tu clave en secreto: llama a la API desde tu servidor, bot o backend – quien tenga la clave consume tu cuota. Puedes revocar una clave en cualquier momento en los ajustes y crear una nueva; la antigua deja de funcionar al instante.

¿Más rendimiento? Suscripción de apoyo opcional

Por 3,99 €/mes apoyas los costes del servidor y tu límite sube de 60 a 300 peticiones por minuto. Cancelable cada mes en el portal de cliente.

Los datos del juego siguen siendo de libre acceso para todos – la suscripción de apoyo solo paga capacidad de servidor (un límite mayor), nunca los datos. DayZ y sus datos pertenecen a Bohemia Interactive a.s.

Gestionar suscripción y claves

Clave API obligatoria

Envía la clave como cabecera «Authorization: Bearer» o «X-Api-Key» en cada petición.

60 → 300 peticiones/min

Gratis: 60 peticiones por minuto por clave. Con la suscripción de apoyo opcional: 300/min. Cada respuesta lleva cabeceras X-RateLimit, incl. X-RateLimit-Tier.

Datos reales del juego

Extraídos directamente de las configs de DayZ, actualizados tras cada parche.

GET`/api/v1/items`

Buscar y filtrar objetos (paginado)

Parámetro	Descripción
q	Búsqueda en nombre y nombre de clase (fuzzy)
cat	Categoría, p. ej. Weapon, Food / Drink, Ammo
tier	Tier de loot: Tier1 – Tier4 o Unique
sort	name (por defecto), damage, rpm o weight
page	Página, desde 1
limit	Resultados por página, 1–100 (por defecto 48)
icons	1 = solo objetos con icono
lang	Idioma del campo name: en, de, fr, es, it (por defecto en)

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

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

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

Objeto individual con todos los detalles

Acepta nombres de clase (sin distinguir mayúsculas) o slugs. Devuelve todos los campos: estadísticas de armas, munición, cargadores, accesorios, datos de loot, edificios de aparición, recetas, todos los nombres traducidos y los datos brutos completos de la config del juego.

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

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

GET`/api/v1/categories`

Todas las categorías con número de objetos

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

GET`/api/v1/meta`

Información del dataset: fecha de importación, número de objetos, build del juego

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

Errores, límites y estabilidad

Los errores son siempre JSON con un código estable, un mensaje legible y un enlace a la documentación:

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

Estado · código	Significado
401 · missing_api_key	No se envió clave API. Añade la cabecera «Authorization: Bearer» o «X-Api-Key».
401 · invalid_api_key	La clave no existe o fue revocada.
404 · not_found	No hay ningún objeto con ese nombre de clase o slug.
429 · rate_limited	Límite agotado – espera Retry-After segundos y vuelve a intentarlo.
5xx	Error del servidor – puedes reintentar sin problema. Si persiste, repórtalo en nuestro Discord.

Cada respuesta correcta incluye cabeceras de rate-limit para que tu cliente pueda autorregularse:

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

Reglas del juego

Una suscripción cubre tus proyectos, bots y herramientas de servidor – uso justo dentro del límite.
Si lo usas en tus proyectos, agradecemos un enlace a dzpage.com.
Los iconos (URLs icon / icon_thumb) siguen siendo enlazables libremente – caché de larga duración, sin clave.
Esta API es v1: pueden añadirse campos, los existentes no se eliminarán ni renombrarán.

Acceso y uso justo

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories