📘 مستندات API تبدیل فایل FileKit

مستندات کامل API برای توسعه‌دهندگان جهت تبدیل فایل‌ها به فرمت‌های مختلف. این API برای استفاده در SaaS، وب‌سرویس‌ها و اپلیکیشن‌ها طراحی شده است.

REST API Secure File Processing

⚡ شروع سریع

برای استفاده از API کافیست یک درخواست POST به endpoint زیر ارسال کنید.

POST https://api.filekit.ir/v1/convert

📡 آدرس سرویس (Endpoint)

این آدرس برای ارسال درخواست‌های تبدیل فایل استفاده می‌شود.

POST https://api.filekit.ir/v1/convert

📦 پارامترهای درخواست

apikey
کلید اختصاصی کاربر برای احراز هویت API
file
فایل ورودی (آپلود مستقیم یا Base64)
output_type
فرمت خروجی: txt / json / csv / pdf

📤 ساختار پاسخ API

در صورت موفقیت، API لینک فایل خروجی را برمی‌گرداند.

{
  "status": "success",
  "data": {
    "url": "https://filekit.ir/files/output.txt"
  }
}

⚠️ مدیریت خطاها

در صورت خطا، پیام و کد وضعیت بازگردانده می‌شود.

{
  "status": "error",
  "message": "Invalid API Key",
  "code": 401
}
📚 راهنمای سریع
• Endpoint
• Parameters
• Response
• Errors
💡 نکته توسعه‌دهنده
تمام درخواست‌ها باید با API Key معتبر ارسال شوند و پاسخ‌ها همیشه JSON هستند.