Static Service API
Static file management & serving API for Taymay ecosystem
Authentication
POST
/api/auth/login
Login with username & password. Returns JWT token.
GET
/api/auth/me Auth required
Get current user info from JWT token.
File Management
GET
/api/files/ Auth required
List files. Query: category, search, page, page_size
POST
/api/files/upload Auth required
Upload a file. Form: file (required), path (optional custom path)
POST
/api/files/upload/batch Auth required
Upload multiple files. Form: files (multiple), path (optional)
GET
/api/files/{path} Auth required
Get file metadata by path.
DELETE
/api/files/{path} Auth required
Delete a file by path.
GET
/api/files/categories Auth required
List categories with file counts and sizes.
GET
/api/files/tree Auth required
Get directory tree. Query: prefix (optional path prefix)
Static File Serving
GET
/static/{path}
Serve static files directly (no auth). Example: /static/image/logo.png
Version Management
GET
/api/versions/current
Get current version (public).
GET
/api/versions/ Auth required
List all version records.
POST
/api/versions/ Auth required
Create version record. JSON: version, changelog
GET
/api/versions/stats Auth required
Get storage statistics (total files, size, categories).
Health Check
GET
/health
Health check endpoint. Returns status and version.
Dashboard: static.app.hihoay.com |
API: static.api.hihoay.com