McDev Daten-API v1

Read-only Zugriff auf ausgewählte McDev-Fortnite-Daten. Die API schreibt keine Shop-/Karteninhalte und startet keine externen Provider-Abfragen für API-Kunden.

Zugang

Ein API-Key wird von McDev vergeben und genau einmal im Klartext angezeigt. Sende ihn serverseitig als Bearer-Token:

curl -H 'Authorization: Bearer mcdv1_…' \
  'https://mcdev.tv/api/v1/shop'

Keys gehören nicht in Query-Strings, Browser-JavaScript, öffentliche Repositories oder Client-Apps. Query-Parameter wie ?key= werden absichtlich abgelehnt.

Shop

GET /api/v1/shop liefert den aktuellen lokal gespeicherten Shop. Optional: ?day=YYYY-MM-DD für einen vorhandenen Archivtag.

GET /api/v1/shop?day=2026-08-15

Antwortfelder umfassen Name, Typ, Seltenheit, Set, Preis, frühere Auftritte und die kanonische McDev-Skin-URL. Historische Cache-Misses besitzen zusätzlich ein globales Cold-Start-Budget zum Schutz der Datenbank.

Karte

GET /api/v1/map?view=markers liefert redaktionell gepflegte Marker per Keyset-Pagination. Parameter: limit=1..250, after_id, optional layer, lang=de|en.

GET /api/v1/map?view=markers&limit=100&layer=truhe
GET /api/v1/map?view=pois&lang=en

Die POI-Fassung liest ausschließlich den bereits vorhandenen Karten-Cache. Ist er nicht vorbereitet, antwortet die API mit 503 statt für einen API-Aufruf einen externen Live-Fetch zu starten.

Limits & Fehler

Jeder Key hat ein eigenes Stundenlimit. Erfolgreiche Antworten senden X-RateLimit-Limit und X-RateLimit-Remaining; bei 429 zusätzlich Retry-After. HTTP 401 = Key fehlt/ungültig, 403 wird nicht zum Erraten von Scopes verwendet, 429 = Limit, 503 = lokale Datenquelle gerade nicht verfügbar.

Die API stellt McDev-Daten bereit und ist keine offizielle Epic-Games-Schnittstelle. Fortnite ist eine Marke von Epic Games.