Confluence (Atlassion)

Diese Anleitung zeigt dir, wie du mithilfe der Confluence Cloud REST API alle Seiten (Knowledge-Artikel) aus einem bestimmten Space abrufen kannst. Ideal für Datenexporte, Automatisierungen oder Integrationen mit anderen Systemen.

---

🔧 Voraussetzungen

Bevor du startest, stelle sicher, dass du Folgendes hast:

• Zugriff auf Confluence Cloud

• Den Space-Key des gewünschten Bereichs (z. B. KNOW)

• Deine Atlassian-E-Mail-Adresse

• Einen gültigen API-Token

Wenn du noch keinen API-Token besitzt, kannst du ihn in deinem Atlassian-Konto erstellen – siehe nächster Abschnitt.

---

🔐 API-Token erstellen (Atlassian Cloud)

1. Öffne dein Atlassian-Konto unter: https://id.atlassian.com/manage-profile/security

2. Scrolle nach unten zum Abschnitt „API tokens“.

3. Klicke auf „Create API token“.

4. Gib dem Token einen Namen (z. B. Confluence API Export).

5. Bestätige mit „Create“.

6. Kopiere den angezeigten Token – du wirst ihn nur einmal sehen.

Bewahre deinen API-Token sicher auf! Er ersetzt dein Passwort bei der Authentifizierung in der API und gewährt vollen Zugriff auf deine Atlassian-Daten.

---

📥 API-Aufruf vorbereiten

Nutze die folgende URL-Struktur, um Seiten aus einem bestimmten Space abzurufen:

GET https://<DEINE-DOMAIN>.atlassian.net/wiki/rest/api/content

Nützliche Parameter:

Parameter	Beschreibung
spaceKey=KNOW	Filtert Ergebnisse auf den angegebenen Space
type=page	Gibt nur Seiten zurück (keine Blogposts)
limit=25	Anzahl der Ergebnisse pro Anfrage
start=0	Startwert für die Pagination
expand=body.storage	Liefert den vollständigen HTML-Inhalt der Seiten

Beispiel:

curl -u [email protected]:DEIN_API_TOKEN \
  "https://deinedomain.atlassian.net/wiki/rest/api/content?spaceKey=KNOW&type=page&limit=25&expand=body.storage"

Du kannst zusätzliche Parameter wie expand=version,history hinzufügen, um mehr Metadaten zu erhalten.

---

🔑 Authentifizierung

Die Confluence API verwendet Basic Auth:

Feld	Wert
Benutzername	Deine Atlassian-E-Mail-Adresse
Passwort	Dein zuvor erzeugter API-Token

Diese Authentifizierung kann direkt in Tools wie curl, Postman oder in Skripten (z. B. Python) verwendet werden.

In Postman kannst du den Auth-Typ „Basic Auth“ wählen und E-Mail + Token dort direkt eingeben.

---

🔄 Pagination

Confluence liefert die Ergebnisse paginiert zurück. Das bedeutet: Du musst die API mehrfach aufrufen, bis keine neuen Seiten mehr vorhanden sind.

Beispiel:

start=0
start=25
start=50
...

Jede Antwort enthält das Feld "size" (Anzahl der gelieferten Elemente) und "limit" (Anzahl pro Seite).

Überprüfe im Response das Feld "hasMore" oder vergleiche "size" mit "limit", um zu erkennen, ob du weitere Seiten abrufen musst.

---

📄 Ergebnisdaten

Die API gibt zu jeder Seite unter anderem folgende Felder zurück:

Feld	Beschreibung
title	Seitentitel
body.storage.value	Vollständiger HTML-Inhalt
id	Eindeutige Seiten-ID
version	Versionsnummer
createdBy	Benutzer, der die Seite erstellt hat
createdDate	Erstellungsdatum

Beispielhafte Antwortstruktur:

{
  "results": [
    {
      "id": "123456",
      "title": "Beispielseite",
      "body": {
        "storage": {
          "value": "<p>HTML-Inhalt der Seite</p>"
        }
      },
      "version": { "number": 5 },
      "history": { "createdBy": { "displayName": "Max Mustermann" } }
    }
  ]
}

---

📚 Weitere Ressourcen

Offizielle Confluence API-Dokumentation: 👉 https://developer.atlassian.com/cloud/confluence/rest/api-group-content/

✅ Nach diesen Schritten kannst du Inhalte aus einem Confluence-Space abrufen, verarbeiten und für Berichte, Backups oder Integrationen weiterverwenden.