---
title: "Authentifizierung und Beispiele"
description: "Den API-Schlüssel als Bearer-Token senden – Beispiele mit curl, PHP, Node.js und Python"
---

Jeder Aufruf der REST-API trägt den Schlüssel in der HTTP-Kopfzeile `Authorization`:

```http
Authorization: Bearer qt_Ab12Cd34_…
```

Die API ist **zustandslos**: keine Anmeldung, keine Cookies, kein CSRF-Token. Alle Pfade beginnen mit `https://<deine-installation>/api/rest/v1/`. Antworten sind `application/json`, Fehler `application/problem+json` (siehe [Fehler](/rest-api/konventionen#fehler)). Bodies schickst du als JSON mit `Content-Type: application/json`.

Der erste Aufruf ist meist die Liste der Communities, die der Schlüssel erreicht – deren `slug` steht danach in jedem Pfad.

## curl

```bash
export QT_URL="https://community.example.org"
export QT_KEY="qt_Ab12Cd34_…"

# Communities, die der Schlüssel erreicht
curl -s -H "Authorization: Bearer $QT_KEY" "$QT_URL/api/rest/v1/communities"

# Wartende Beitrittsanfragen
curl -s -H "Authorization: Bearer $QT_KEY" "$QT_URL/api/rest/v1/communities/mein-verein/join-requests"

# Eine Anfrage freigeben (Schlüssel mit „lesen und schreiben“)
curl -s -X POST -H "Authorization: Bearer $QT_KEY" \
  "$QT_URL/api/rest/v1/communities/mein-verein/join-requests/0192d4c2-6f1a-7c3e-9b1a-2f4e5d6c7b8a/approve"

# Event anlegen (Wandzeit in der angegebenen Zeitzone)
curl -s -X POST -H "Authorization: Bearer $QT_KEY" -H "Content-Type: application/json" \
  -d '{"title":"Stammtisch","startsAt":"2026-11-05T19:00","endsAt":"2026-11-05T21:00","timezone":"Europe/Berlin","capacity":30,"waitlistEnabled":true}' \
  "$QT_URL/api/rest/v1/communities/mein-verein/events"
```

## PHP

Mit dem HTTP-Client von Symfony (`composer require symfony/http-client`); jeder andere Client (Guzzle, cURL) funktioniert genauso.

```php
<?php
require 'vendor/autoload.php';

use Symfony\Component\HttpClient\HttpClient;

$client = HttpClient::createForBaseUri('https://community.example.org/api/rest/v1/', [
    'auth_bearer' => getenv('QT_KEY'),
    'headers' => ['Accept' => 'application/json'],
]);

// Alle aktiven Mitglieder, Seite für Seite
$page = 1;
do {
    $data = $client->request('GET', 'communities/mein-verein/members', [
        'query' => ['page' => $page, 'itemsPerPage' => 100],
    ])->toArray();
    foreach ($data['items'] as $member) {
        echo $member['displayName'].' – '.$member['role'].PHP_EOL;
    }
    ++$page;
} while ($data['hasMore']);
```

## Node.js

Node.js ab Version 18 hat `fetch` eingebaut.

```javascript
const base = 'https://community.example.org/api/rest/v1';
const headers = { Authorization: `Bearer ${process.env.QT_KEY}`, Accept: 'application/json' };

// Termine der nächsten 30 Tage mit freien Plätzen
const from = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
const to = new Date(Date.now() + 30 * 86400_000).toISOString().replace(/\.\d{3}Z$/, 'Z');
const res = await fetch(`${base}/communities/mein-verein/events?from=${from}&to=${to}`, { headers });
if (!res.ok) {
  const problem = await res.json();
  throw new Error(`${res.status} ${problem.title}: ${problem.detail ?? ''}`);
}
const { items } = await res.json();
for (const event of items) {
  console.log(event.occurrenceStart, event.title, event.spotsLeft ?? 'unbegrenzt');
}
```

## Python

Mit `requests` (`pip install requests`):

```python
import os
import requests

session = requests.Session()
session.headers.update({"Authorization": f"Bearer {os.environ['QT_KEY']}", "Accept": "application/json"})
base = "https://community.example.org/api/rest/v1"

# Kurs für ein Mitglied freischalten, befristet bis Jahresende
response = session.post(
    f"{base}/communities/mein-verein/courses/0192d4c2-1111-7c3e-9b1a-2f4e5d6c7b8a/access",
    json={"userId": "0192d4c2-6f1a-7c3e-9b1a-2f4e5d6c7b8a", "expiresAt": "2026-12-31T23:59:59+01:00"},
)
if response.status_code == 429:
    print("Limit erreicht, erneut in", response.headers["Retry-After"], "Sekunden")
response.raise_for_status()
print(response.json())
```

<Note>
Bewahre den Schlüssel in einer Umgebungsvariable oder einem Geheimnis-Speicher deines Systems auf, nicht im Code. Für Skripte, die nur lesen, genügt ein Schlüssel mit **Nur lesen**.
</Note>
