33 lines
675 B
Markdown
33 lines
675 B
Markdown
|
# API erweitern
|
||
|
|
|
||
|
|
Letzte Aktualisierung: 2026-02-24
|
||
|
|
|
||
|
|
## Ziel
|
||
|
|
|
||
|
|
API-Änderungen konsistent ausrollen (Code + Spec + Test).
|
||
|
|
|
||
|
|
## Ablauf
|
||
|
|
|
||
|
|
1. Endpoint in `pages/api/v1/**` anpassen.
|
||
|
|
2. Service/Repository bei Bedarf erweitern.
|
||
|
|
3. OpenAPI in `/docs/openapi.yaml` im selben Change aktualisieren.
|
||
|
|
4. Endpoint per cURL/Postman gegenprüfen.
|
||
|
|
|
||
|
|
## API-Regeln
|
||
|
|
|
||
|
|
- UUID-first nach außen
|
||
|
|
- Einheitliche Fehlerstruktur (`error`, optional `errors`)
|
||
|
|
- Auth/Scope-Regeln unverändert einhalten
|
||
|
|
|
||
|
|
## Minimaltest
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -H "Authorization: Bearer <TOKEN>" \
|
||
|
|
http://localhost:8080/api/v1/me
|
||
|
|
```
|
||
|
|
|
||
|
|
## Vertiefung
|
||
|
|
|
||
|
|
- API-Referenz: `/docs/api.md`
|
||
|
|
- Sicherheitsdetails: `/docs/sicherheitsmodell.md`
|