API REST · v1

API d'objets DayZ

Toute la base de données d'objets en JSON – utilisable gratuitement avec une clé API personnelle. Pour bots Discord, outils serveur, overlays et vos propres projets.

Accès & fair use

Tous les endpoints /api/v1 nécessitent une clé API gratuite – elle empêche les abus et permet des limites équitables. Aucun abonnement requis.

Connectez-vous avec Discord – le compte est gratuit.
Créez une clé API gratuite dans vos paramètres.
Créez une clé API et envoyez-la avec chaque requête.

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

Gardez votre clé secrète : appelez l'API depuis votre serveur, bot ou backend – quiconque possède la clé consomme votre quota. Vous pouvez révoquer une clé à tout moment dans les paramètres et en créer une nouvelle ; l'ancienne cesse immédiatement de fonctionner.

Besoin de plus de débit ? Abonnement soutien optionnel

Pour 3,99 €/mois, vous soutenez les coûts serveur et votre limite passe de 60 à 300 requêtes par minute. Résiliable chaque mois dans le portail client.

Les données du jeu restent librement accessibles à tous – l'abonnement soutien ne paie que la capacité serveur (limite plus élevée), jamais les données. DayZ et ses données appartiennent à Bohemia Interactive a.s.

Gérer l'abonnement & les clés

Clé API requise

Envoyez la clé dans l'en-tête « Authorization: Bearer » ou « X-Api-Key » à chaque requête.

60 → 300 requêtes/min

Gratuit : 60 requêtes par minute et par clé. Avec l'abonnement soutien optionnel : 300/min. Chaque réponse porte des en-têtes X-RateLimit, dont X-RateLimit-Tier.

Vraies données du jeu

Extraites directement des configs DayZ, mises à jour après chaque patch.

GET`/api/v1/items`

Rechercher et filtrer les objets (paginé)

Paramètre	Description
q	Recherche dans le nom et le nom de classe (fuzzy)
cat	Catégorie, ex. Weapon, Food / Drink, Ammo
tier	Tier de loot : Tier1 – Tier4 ou Unique
sort	name (défaut), damage, rpm ou weight
page	Page, à partir de 1
limit	Résultats par page, 1–100 (défaut 48)
icons	1 = uniquement les objets avec icône
lang	Langue du champ name : en, de, fr, es, it (défaut en)

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

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

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

Objet unique avec tous les détails

Accepte les noms de classe (insensible à la casse) ou les slugs. Renvoie tous les champs : stats d'armes, munitions, chargeurs, accessoires, données de loot, bâtiments d'apparition, recettes, tous les noms traduits et les données brutes complètes de la config du jeu.

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

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

GET`/api/v1/categories`

Toutes les catégories avec nombre d'objets

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

GET`/api/v1/meta`

Infos du jeu de données : date d'import, nombre d'objets, build du jeu

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

Erreurs, limites & stabilité

Les erreurs sont toujours en JSON avec un code stable, un message lisible et un lien vers la doc :

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

Statut · code	Signification
401 · missing_api_key	Aucune clé API envoyée. Ajoutez l'en-tête « Authorization: Bearer » ou « X-Api-Key ».
401 · invalid_api_key	La clé n'existe pas ou a été révoquée.
404 · not_found	Aucun objet avec ce nom de classe ou ce slug.
429 · rate_limited	Limite atteinte – attendez Retry-After secondes puis réessayez.
5xx	Erreur serveur – réessayez sans risque. Si cela persiste, signalez-le sur notre Discord.

Chaque réponse réussie inclut des en-têtes de rate-limit pour que votre client puisse se réguler :

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

Règles du jeu

Un abonnement couvre vos projets, bots et outils serveur – fair use dans la limite de débit.
Si vous l'utilisez dans vos projets, un lien vers dzpage.com est apprécié.
Les icônes (URLs icon / icon_thumb) restent librement hotlinkables – cache longue durée, aucune clé requise.
Cette API est en v1 : des champs peuvent être ajoutés, les champs existants ne seront ni supprimés ni renommés.

Accès & fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories