Statt für jede TYPO3-Job-Erweiterung einen separaten Adapter zu pflegen, installieren Sie auf Ihrer TYPO3-Site eine einzige BAconn-Reader-Extension — sie erkennt automatisch, welche Jobs-Extension läuft, und liefert eine einheitliche REST-Schnittstelle.

Reader-Extension-Vertrag

Die Extension exponiert drei Endpunkte unter /api/baconn/v1/:

  • GET /health — gibt erkanntes Schema und Extension-Version zurück
  • GET /fields — listet verfügbare Felder mit Typen für das Mapping-UI
  • GET /jobs?since=iso8601 — paginierte Stellen-Liste, optional inkrementell

Authentifizierung per API-Key im X-API-Key-Header.

Einrichtung

  1. TYPO3-Site: Reader-Extension installieren (Composer: composer require baconn/typo3-reader, oder via TER-Manager). Im Backend → Erweiterungen aktivieren.
  2. Extension konfigurieren: API-Key generieren (Extension-Backend-Modul). Optional: aktivierte Job-Extensions auswählen, falls mehrere parallel laufen.
  3. BAconn: "Neue Quelle" → TYPO3 → Basis-URL + API-Key eingeben. "Verbindung testen" lädt das erkannte Schema.
  4. Feld-Mapping vornehmen — die TYPO3-Reader-Extension liefert sprachneutrale Feld-IDs.

Status der Reader-Extension

Stand 2026-04: Reader-Extension ist als separates TER-Paket in Vorbereitung. Bis zur Freigabe können TYPO3-Kunden den JSON-LD-Adapter nutzen, sofern Stellen mit schema.org-Markup ausgeliefert werden (Standard bei vielen TYPO3-Themes).

Warum eine Reader-Extension statt direktem Datenbank-Zugriff

TYPO3-Sites haben oft eigene Erweiterungen (RKW Jobs, custom Extbase, t3blog-jobs etc.) mit unterschiedlichen Tabellen-Strukturen. Eine Reader-Extension auf Kundenseite ist die einzige zukunftssichere Brücke — Updates der Job-Extension brechen den Sync nicht, da die Reader-Extension Schema-Drift abfängt.