Docs | Fik Uploader

Back to Upload

Base URL

bash

$ https://your-domain.com

Endpoints

POST /api/upload

Upload file to the server. Public endpoint - no authentication required.

Public 25MB Max 20/min

Request:

Content-Type: multipart/form-data
Field: file (binary)

Response:

{"status":true,"result":{"name":"abc.jpg","url":"https://domain.com/files/abc.jpg","mime":"image/jpeg","isNew":true}}

GET /files/:filename

Retrieve uploaded file via jsDelivr CDN. Supports HTTP Range for video streaming.

Public Range: Yes CDN: Global

GET /health

Health check endpoint for monitoring service status.

Response:

{"status":"ok","timestamp":"2025-03-28T13:00:00.000Z","uptime":3600.5}

Rate Limits

API Upload: 20 requests/minute per IP
File Download: Unlimited (CDN cached)

Supported File Types

JPEG PNG WEBP GIF MP4 WEBM MOV

✓ MIME type validation enforced

Examples

JavaScript

const fd = new FormData()
fd.append('file', fileInput.files[0])

const res = await fetch('/api/upload', {
  method: 'POST',
  body: fd
})

const data = await res.json()
console.log(data.result.url)

cURL

curl -X POST https://your-domain.com/api/upload \
  -F "file=@image.jpg"

# Response:
# {"status":true,"result":{"name":"abc.jpg","url":"https://..."}}

Python

import requests

files = {'file': open('image.jpg', 'rb')}
res = requests.post('https://your-domain.com/api/upload', files=files)

print(res.json()['result']['url'])

API DOCUMENTATION