← Zurück zum Hilfe-Center

developer

API-Integration

Schreibgeschützte öffentliche API, um die Berichterstattung von Echo Harbor in andere Systeme zu integrieren.

Die öffentliche API befindet sich unter `/api/v1` und erfordert bei jeder Anfrage einen `X-API-Key`-Header.

**Endpunkte**
- `GET /api/v1/articles` – veröffentlichte Artikel auflisten; unterstützt `?page=N` und `?q=search`
- `GET /api/v1/articles/{slug}` – einen Artikel per Slug mit vollständigen Hearth-Metadaten abrufen
- `GET /api/v1/topics` – alle veröffentlichten Themencluster auflisten

**Antworten**
Alle Antworten sind JSON. Artikel-Payloads enthalten Titel, Slug, Zusammenfassung, Publikation, Quell-URL, Veröffentlichungsdatum, Hearth-Metadaten (Erzählung, hervorgehobenes Zitat, zentrale Fakten, zentrale Zitate, Lesetiefen), Vertrauenswert und Themenzuordnung.

**Authentifizierung**
API-Schlüssel werden unter Admin > Publishing verwaltet. Übergeben Sie Schlüssel niemals in URLs – verwenden Sie immer den `X-API-Key`-Header. Für alle öffentlichen Endpunkte gelten Ratenbegrenzungen.

Kontakt FAQ