# Erste Schritte

Vom API-Schlüssel zum ersten Aufruf: Schlüssel erzeugen, mit curl anfragen, Antworten lesen und Wiederholungen von Anfang an absichern.

> **Typ:** bereich
> **Für wen:** Entwicklerinnen und Entwickler, die zum ersten Mal gegen die Szenera-API arbeiten — mit einem Konto in einer Organisation, deren Paket den API-Zugang enthält.

![Die Portalseite Einstellungen › Organisation › API-Schlüssel: links die Bereichsliste, rechts die Schaltfläche Schlüssel erstellen und die Tabelle der ausgestellten Schlüssel mit Name und Rechten, Klasse, Ersteller, Erstellungszeitpunkt, Gültigkeit und letzter Benutzung](/de/getting-started/bilder/5cc8d110-overview.png)

_Hier beginnt jede Anbindung: Der Schlüssel entsteht im Portal, alles Weitere läuft über die API._

## Orientierung

| Seite | Wann Sie es brauchen |
|---|---|
| [Wie läuft ein Aufruf durch die Plattform?](/de/getting-started/about-request-flow) | Von der Bearer-Kopfzeile über die Rechteprüfung bis zur Antwort mit Trace-Kennung: die Stationen, die jeder Aufruf durchläuft. |

## Der erste Aufruf

| Seite | Wann Sie es brauchen |
|---|---|
| [Einen API-Schlüssel erzeugen](/de/getting-started/create-api-key) | Im Portal unter Einstellungen › Organisation › API-Schlüssel einen Schlüssel mit Klasse, Rechten und Ablauf anlegen — der Klartext erscheint genau einmal. |
| [Der erste Aufruf mit curl](/de/getting-started/first-call) | Mit Schlüssel und curl GET /v1/me und GET /v1/playlists aufrufen, die Antwort und ihre Kopfzeilen ansehen — in fünf Minuten. |
| [Was eine Antwort enthält](/de/getting-started/response-contents) | Status, Kopfzeilen, Listenform, Kennungen mit Präfix und der Fehlerrumpf — alles, was in einer Antwort der API steckt, in Tabellen. |
| [Idempotenz von Anfang an](/de/getting-started/idempotency) | Verändernde Aufrufe mit Idempotency-Key absichern, damit eine Wiederholung nach Netzabbruch keinen zweiten Vorgang erzeugt. |

## Wenn es hakt

| Seite | Wann Sie es brauchen |
|---|---|
| [Wenn der erste Aufruf scheitert](/de/getting-started/troubleshooting) | 401, 403, 404, 422, 429 und Netzfehler beim ersten Aufruf: was der Code bedeutet und welche Seite den Weg zurück zeigt. |