Eigene Identität in der API: prüfen + dokumentieren #147

New Issue

fable-5 · 2026-07-20T00:15:47+02:00

fable-5 commented

2026-07-20 00:15:47 +02:00

Ziel

Der Weg zur eigenen User-ID ist in der API-Doku klar auffindbar. Befund der Planung: GET /api/v1/auth/me (intern) und GET /api/public/v1/me (PAT; liefert Nutzer + zugängliche Teiche, public-api.controller.ts:71) existieren bereits — der frühere Fehlbefund galt dem Pfad /users/me.

Umsetzungsskizze

OpenAPI-Spec (apps/api/src/public-api/openapi.ts) prüfen: ist /me beschrieben, inkl. Hinweis „User-ID hier"? Sonst ergänzen.
API-Doku (docs en/de) entsprechend ergänzen.
MCP-Parität prüfen: gibt es ein whoami-/me-Tool? Falls nein, ergänzen oder im Issue dokumentieren, warum nicht.
KEIN neuer Endpoint, außer beim Doku-Check fällt eine echte Lücke auf.

Akzeptanzkriterien

OpenAPI + Doku nennen den Weg zur eigenen User-ID (beide APIs).
MCP bietet die Info an oder die bewusste Auslassung ist dokumentiert.

## Ziel Der Weg zur eigenen User-ID ist in der API-Doku klar auffindbar. Befund der Planung: `GET /api/v1/auth/me` (intern) und `GET /api/public/v1/me` (PAT; liefert Nutzer + zugängliche Teiche, `public-api.controller.ts:71`) existieren bereits — der frühere Fehlbefund galt dem Pfad `/users/me`. ## Umsetzungsskizze - OpenAPI-Spec (`apps/api/src/public-api/openapi.ts`) prüfen: ist `/me` beschrieben, inkl. Hinweis „User-ID hier"? Sonst ergänzen. - API-Doku (docs en/de) entsprechend ergänzen. - MCP-Parität prüfen: gibt es ein whoami-/me-Tool? Falls nein, ergänzen oder im Issue dokumentieren, warum nicht. - KEIN neuer Endpoint, außer beim Doku-Check fällt eine echte Lücke auf. ## Akzeptanzkriterien - OpenAPI + Doku nennen den Weg zur eigenen User-ID (beide APIs). - MCP bietet die Info an oder die bewusste Auslassung ist dokumentiert.

fable-5 added this to the M21 — API & Feeds milestone 2026-07-20 00:15:47 +02:00

fable-5 referenced this issue

2026-07-20 00:51:20 +02:00

M21: API & Feeds — me-Doku (#147), since-Filter (#148), Atom-Feeds (#149) #157

fable-5 referenced this issue from a commit

2026-07-20 00:51:21 +02:00

#147: Eigene Identität in der API klar dokumentiert

fable-5 closed this issue

2026-07-20 01:06:20 +02:00

fable-5 commented

2026-07-20 01:06:21 +02:00

Befund bestaetigt und umgesetzt in PR #157 (89ffbc0): GET /api/public/v1/me existierte bereits (liefert user.id/username/displayName, Scope, Teich-Beschraenkung) — der fruehere Fehlbefund galt nur dem Pfad /users/me. OpenAPI-Summary nennt jetzt ausdruecklich die User-ID, api-guide en+de ebenso; MCP war bereits paritaetisch. Kein neuer Endpoint noetig.

Befund bestaetigt und umgesetzt in PR #157 (89ffbc0): GET /api/public/v1/me existierte bereits (liefert user.id/username/displayName, Scope, Teich-Beschraenkung) — der fruehere Fehlbefund galt nur dem Pfad /users/me. OpenAPI-Summary nennt jetzt ausdruecklich die User-ID, api-guide en+de ebenso; MCP war bereits paritaetisch. Kein neuer Endpoint noetig.

Sign in to join this conversation.