Clean up OpenAPI scripts

This commit is contained in:
gabdevele
2026-06-03 01:34:27 +02:00 Unverified
parent 74ff09fefe
commit 1043768da7
15 changed files with 379 additions and 48 deletions
+4 -3
View File
@@ -7,14 +7,15 @@
than plain SHA-256 and available through the existing OpenSSL dependency.
- Added report media uploads at `POST /api/v1/reports/{id}/media`.
- Supported JPEG, PNG, WebP, MP4, WebM and QuickTime uploads.
- Removed the old `/photos` upload path; report attachments now use `/media`.
- Added generated OpenAPI JSON from Drogon controller route macros.
- Report attachments now use the `/media` upload path.
- Added generated OpenAPI JSON from Drogon controller route macros and adjacent
metadata blocks.
- Exposed `/api/v1/openapi.json` and `/api/v1/docs`.
- Added a small Streamlit API lab for visual endpoint testing.
## To do next
- Add richer OpenAPI schema metadata for request and response bodies.
- Consider extracting `generate_openapi.py` into an open-source standalone
- Consider extracting `scripts/generate_openapi.py` into an open-source standalone
project once the conventions stabilize.
- Add minimal media upload integration tests after endpoint contracts settle.
- Keep API and docs on `media` terminology only.