📡 مستندات 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
سایت در حال تعمیر است