BERDA Public Data API.

Schnelleinstieg

Alle Endpoints liefern JSON, sind UTF-8-kodiert und CORS-frei. Die Base-URL ist https://www.berda-maschinen.de.

Endpoints

• GET /api/brands.json

  Alle Marken im BERDA-Portfolio (STARTRAC, FELDMANN, KELLFRI, STAHLHOFF, NEOMACH) mit Kategorie, Rolle, Produkten, Bildern und Stock-Status.

• GET /api/products.json

  Produkt-Kategorien (Kompakttraktoren, Minibagger, Hoflader, Teleskopstapler, Anbaugeräte) mit Marken-Mapping und typischen Anwendungsfällen.

• GET /api/contact.json

  Unternehmensdaten, Adresse, Geo-Koordinaten, Telefon/E-Mail-Kanäle, Service-Gebiet (DACH).

• GET /api/opening-hours.json

  Öffnungszeiten Mo–So mit Schema.org-Spec und RFC 5545 RRULE für Kalender-Integration.

• GET /api/dealers.json

  Dealer-Netzwerk: 30+ autorisierte Händler in DE/AT/CH, regionale Landing-Pages pro Bundesland und Großstadt.

Beispiel-Aufruf

Klassischer fetch:

// Brands abrufen
const res = await fetch('https://www.berda-maschinen.de/api/brands.json');
const data = await res.json();
console.log(data.brands.map(b => b.name));
// [ "STARTRAC", "FELDMANN", "KELLFRI", "STAHLHOFF", "NEOMACH" ]

Öffnungszeiten heute (Beispiel-Logik):

const hours = await fetch('/api/opening-hours.json').then(r => r.json());
const today = hours.regular_hours[(new Date().getDay() + 6) % 7];
console.log(today.is_open ? `Heute geöffnet: ${today.opens}–${today.closes}` : 'Heute geschlossen');

OpenAPI 3.1 Spec

Vollständige Schema-Beschreibung aller Endpoints unter /api/openapi.json. Importierbar in Postman, Insomnia, Swagger Editor, oder als Tool-Definition für AI-Agents.

MCP-kompatibel

Ein /.well-known/mcp.json Manifest beschreibt die Endpoints im Model Context Protocol Format. Agents die MCP-Resources verstehen, können die BERDA-Daten direkt einlesen.

Da BERDA keine schreibenden Operationen bietet (kein Booking, keine Bestellannahme), ist die MCP-Anbindung rein lesend. Für aktiven Kontakt verweisen Agents auf das Kontaktformular.

llms.txt

Für LLM-Crawler liegt zusätzlich eine /llms.txt vor - eine Markdown-Übersicht aller wichtigen Seiten, Marken und Suchanfragen-Mappings.

Caching & Updates

Die Endpoints sind statisch deployed. Jede Antwort enthält ein updated-Feld (ISO-Datum) - das ist der zuverlässigste Marker für „letzte Änderung". Standardmäßig kannst du die Daten 24 Stunden cachen.

Lizenz & Nutzung

Die Inhalte stehen für AI-Indexierung, Such-Crawler und vergleichbare Integrationen frei zur Verfügung. Bei manueller Wiederverwendung freuen wir uns über eine Quellangabe (www.berda-maschinen.de). Markenrechte bleiben unberührt.

Kontakt

Fragen, Integrations-Wünsche, Bug-Reports? Mail an info@berda-maschinen.de mit Betreff „Public Data API".