Documentation menu

FiloraFS-Prov1.0.0

FiloraFS-Pro API reference

Try and reference authenticated file, user, and temporary-access endpoints available in FiloraFS-Pro.

Updated

Browser API testing

Run FiloraFS-Pro and open http://localhost:8080/api-test. Register or log in before exercising protected file endpoints.

File endpoints

FiloraFS-Pro file endpoints
MethodPathPurpose
POST/fileUpload a multipart file
GET/file/stream/{id}Stream a file inline
GET/file/download/{id}Download an attachment
GET/file/listList persisted metadata
GET/file/info/{id}Read persisted metadata
DELETE/file/{id}Delete a file
POST/file/generate-pre-signed-urlCreate temporary access
GET/file/presigned/{token}Use a local temporary token
GET/file/thumbnail/{id}Return a thumbnail
POST/fileBearer JWT

Upload one validated multipart file through the configured local or S3 provider and persist its metadata.

Headers

  • Authorization: Bearer <access-token>
  • Content-Type: multipart/form-data

Parameters

  • file — required multipart file part

Relevant errors

  • Unauthorized when the JWT is missing or invalid.
  • Validation failure when file size or content type is rejected.

cURL

cURL
curl -X POST http://localhost:8080/file \
  -H "Authorization: Bearer <access-token>" \
  -F "file=@architecture.pdf"
GET/file/listBearer JWT

Return persisted file metadata. Add pagination and ownership filtering when required by the application.

Headers

  • Authorization: Bearer <access-token>

Relevant errors

  • Unauthorized when the JWT is missing or invalid.
POST/file/generate-pre-signed-urlBearer JWT

Create temporary access for a local or S3-backed file.

Headers

  • Authorization: Bearer <access-token>
  • Content-Type: application/json

Relevant errors

  • Unauthorized for a missing or invalid JWT.
  • Not found when the file does not exist.

Authentication endpoints

FiloraFS-Pro authentication
MethodPathPurpose
POST/api/auth/registerCreate a user
POST/api/auth/loginReturn access and refresh tokens
POST/api/auth/refreshReturn a new token pair
POST/api/auth/logoutInvalidate the refresh session

User endpoints

FiloraFS-Pro users and roles
MethodPathAccess
GET/api/users/meBearer JWT
GET/api/users/profileBearer JWT
GET/api/users/allROLE_ADMIN
GET/api/users/restrictedROLE_USER or ROLE_ADMIN
GET/api/users/admin-onlyROLE_ADMIN