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