# Erste Schritte

Stelle in wenigen Minuten deine erste Anfrage an die aclipp API.

Mit der aclipp API kannst du deinen Workspace programmatisch auslesen und verwalten: Clippings abrufen, Reports erzeugen und die Arbeit automatisieren, die du sonst im Dashboard machst. Alles ist auf einen einzigen Workspace beschränkt, der durch deinen API-Key impliziert wird.

## 1. API-Key erstellen

Öffne die [Workspace-Einstellungen](https://app.aclipp.com/settings/api) und erstelle einen Key. Den vollständigen Key siehst du genau einmal, kopiere ihn dir also an einen sicheren Ort. Gib ihm nur die Scopes, die er wirklich braucht (siehe [Authentifizierung & Scopes](/docs/authentication)).

## 2. Anfrage stellen

Sende den Key als Bearer-Token im `Authorization`-Header. Die Basis-URL ist `https://api.aclipp.com/api/v1`.

```bash
curl "https://api.aclipp.com/api/v1/me" \
  -H "Authorization: Bearer aclipp_live_..."
```

`GET /me` gibt den Workspace, die Scopes und die Projekt-Einschränkung zurück, auf die der Key aufgelöst wird. Das ist der schnellste Weg, um zu prüfen, ob ein Key funktioniert.

## 3. Erkunden

Jeder Endpunkt, seine Parameter sowie Beispielanfragen und -antworten stehen in der [API-Referenz](/docs/api-reference). Ein paar Dinge, die du wissen solltest:

- **Antworten sind JSON.** Fehler nutzen das Format `{ "error": { "code", "message" } }`.
- **Große Listen sind paginiert** über die Parameter `page` und `limit`, wenn der Endpunkt Pagination unterstützt.
- **Anfragen sind pro Workspace rate-limitiert**; bei Überschreitung bekommst du einen `429` mit einem `Retry-After`-Header.

Wenn du bereit bist, lies [Authentifizierung & Scopes](/docs/authentication), um zu verstehen, was ein Key darf und was nicht, und [Rate Limits](/docs/rate-limits), um Retries und Hintergrundjobs zu planen.