📡 مستندات API

با استفاده از API، از برنامه‌های دیگر فایل آپلود کنید

🔑 احراز هویت

کلید API را در هدر درخواست ارسال کنید:

X-Api-Key: your_api_key_here
⬆️ آپلود فایل
POST https://pmup.ir/api/upload.php
پارامتر نوع توضیح
file *الزامی multipart/file فایل مورد نظر
password اختیاری string رمزگذاری فایل

نمونه پاسخ موفق:

{
  "success": true,
  "file_code": "aBcD1234",
  "file_url": "https://pmup.ir/f/aBcD1234",
  "download_url": "https://pmup.ir/d/aBcD1234",
  "original_name": "document.pdf",
  "file_size_fmt": "1 مگابایت",
  "expires_at": null
}

مثال با cURL:

curl -X POST https://pmup.ir/api/upload.php \
  -H "X-Api-Key: your_api_key" \
  -F "file=@/path/to/file.zip"

مثال با Python:

import requests

with open('file.zip', 'rb') as f:
    r = requests.post(
        'https://pmup.ir/api/upload.php',
        headers={'X-Api-Key': 'your_api_key'},
        files={'file': f}
    )
print(r.json())
⚠️ کدهای خطا
400 فایلی ارسال نشده یا فرمت نامعتبر
401 API Key نامعتبر
403 آپلود مهمان غیرفعال / CSRF
413 حجم فایل بیش از حد مجاز
415 پسوند یا نوع فایل مجاز نیست
429 محدودیت نرخ درخواست
503 سایت در حال تعمیر است