- docs/openapi.yaml: vollstaendige OpenAPI 3.1 Spezifikation
- 4 Endpoints: GET /api/notes, GET/PUT /api/notes/{id}, POST /api/sync
- Schemas: NoteData, SyncResult
- Auth: Bearer-Token (optional, HMAC-SHA256)
- Error-Responses: 401 Unauthorized, 404 Not Found, 500 Server Error
- Beispiele fuer jeden Endpoint
- Beschreibung von CORS, Background-Sync, Production-Deployment
Kann genutzt werden mit:
- Swagger UI (statisch aus YAML)
- OpenAPI-Code-Generatoren (Client-SDKs in TS, Python, Go, ...)
- API-Testing-Tools (Postman, Insomnia, etc.)
5.7 KiB
5.7 KiB