API Documentation

Integrate uploads & short links into your apps.

🔑 Authentication

All API endpoints require a Bearer token. Get your token from your profile page.

Authorization: Bearer YOUR_API_TOKEN

📤 Upload File

POST https://i.mizea.my.id/api/upload

Upload one or multiple files. Files >10MB automatically use high-capacity upload (Nitro).

Body: multipart/form-data

  • file - Single file (ShareX compatible)
  • files[] - Multiple files

Response:

{
  "status": "success",
  "files": [{
    "message_id": "123456",
    "url": "https://i.mizea.my.id/123456",
    "friendly_url": "https://i.mizea.my.id/123456/photo.jpg",
    "raw_url": "https://i.mizea.my.id/dl/123456",
    "filename": "photo.jpg"
  }],
  "errors": [],
  "url": "https://i.mizea.my.id/123456/photo.jpg"
}

⚡ ShareX Configuration

Copy this config to ShareX → Custom Uploader Settings:

{
  "Version": "16.1.0",
  "Name": "SCZ Tools",
  "DestinationType": "ImageUploader, FileUploader",
  "RequestMethod": "POST",
  "RequestURL": "https://i.mizea.my.id/api/upload",
  "Headers": {
    "Authorization": "Bearer YOUR_API_TOKEN"
  },
  "Body": "MultipartFormData",
  "FileFormName": "file",
  "URL": "{json:url}",
  "ThumbnailURL": "{json:url}",
  "DeletionURL": ""
}

🔗 Create Short Link

POST https://i.mizea.my.id/api/v1/short-links

Body: application/json

{
  "destination_url": "https://example.com/very-long-url",
  "custom_code": "my-link"  // optional
}

Response:

{
  "status": "success",
  "short_url": "https://i.mizea.my.id/s/my-link",
  "code": "my-link"
}

📄 Get File Info

GET https://i.mizea.my.id/api/v1/files/:messageId

Response:

{
  "status": "success",
  "file": {
    "message_id": "123456",
    "filename": "photo.jpg",
    "mime_type": "image/jpeg",
    "size": 1024000,
    "preview_url": "https://i.mizea.my.id/123456",
    "download_url": "https://i.mizea.my.id/dl/123456",
    "friendly_url": "https://i.mizea.my.id/123456/photo.jpg"
  }
}