🟡 API Überblick

Die dataCycle API ist eine lesende REST-API für strukturierte Inhalte.

Sie stellt konsistente, standardisierte Daten aus dataCycle für Websites, Apps, Karten, Widgets und externe Systeme bereit – unabhängig davon, aus welchen Quellsystemen diese Daten ursprünglich stammen.

Typische Inhalte sind z. B. POIs, Veranstaltungen, Touren, Medien, Produkt- oder Infrastrukturdaten. Welche Datentypen konkret verfügbar sind, hängt von der jeweiligen dataCycle-Instanz ab.

Für wen ist diese API gedacht?

Diese Dokumentation richtet sich an:

Entwickler:innen, die Daten aus dataCycle in Frontends oder Anwendungen nutzen
Agenturen & Integrator:innen, die dataCycle in bestehende Systeme einbinden
Kund:innen, die Inhalte gezielt und kontrolliert ausspielen möchten

Was du mit der API machen kannst

Mit der dataCycle API kannst du:

Inhalte aus Endpoints (vorkonfigurierte Datensammlungen) abrufen
Inhalte nach Text, Klassifizierungen, Attributen, Zeit und Geodaten filtern
verknüpfte Inhalte gezielt mitladen (include)
Responses performant halten (fields, Paging, Sortierung)

Wichtig: Die API ist primär read-only. Schreibzugriffe und Importe erfolgen – falls vorgesehen – über projektspezifische Webhooks und sind nicht Teil des Schnellstarts.

Grundprinzip

dataCycle trennt konsequent:

Datenmodell von Darstellung
Datenpflege von Datennutzung
interne Komplexität von externer API-Stabilität

Die API liefert dir saubere, vorhersehbare Datenstrukturen, damit du dich im Frontend vollständig auf UX und Logik konzentrieren kannst.

➡️ Weiter geht’s mit dem Schnellstart, um in wenigen Minuten die ersten Inhalte abzurufen.