🚀 FITRA - File transfer API

Version: 1.0.0

Simple file upload and download service for developers using HTTP requests in CLI.

📋 API endpoints

POST/upload

Description: Upload a file

cURL Example:

curl -X POST -F "file=@/path/to/your/file.txt" {{.BaseURL}}/upload

GET/uploads/{fileID}/{filename}

Description: Download a file using the ID and filename from upload response

cURL Example:

curl -O {{.BaseURL}}/uploads/{fileID}/{filename}

GET/health

Description: Check service health

cURL Example:

curl {{.BaseURL}}/health

🔄 Usage

Step 1: Upload a file using POST /upload with form-data 'file' parameter

Step 2: Use the returned 'id' and 'filename' to construct download URL

Step 3: Download the file using GET /uploads/{id}/{filename}

💡 Examples

# 1. Upload a file
curl -X POST -F "file=@myfile.txt" {{.BaseURL}}/upload

# Response will include:
# {
#   "id": "abc123...",
#   "filename": "myfile.txt",
#   "url": "{{.BaseURL}}/uploads/abc123.../myfile.txt"
# }

# 2. Download the file
curl -O {{.BaseURL}}/uploads/abc123.../myfile.txt