Pandafile · هر هفته 50 GB رایگان

API انتقال فایل برای اپلیکیشن‌ها و گردش‌کارهای شما

Pandafile یک REST API دارد برای ارسال فایل‌های بزرگ از کد، سرورها و ابزارهای بدون کدنویسی خودتان. یک انتقال بسازید، فایل‌ها را با آپلود قابل ادامه بارگذاری کنید، لینک‌های شخصی را برای گیرندگان ایمیل کنید و وقتی کسی دانلود کرد یک webhook دریافت کنید. این API بخشی از Pro و Team است، از همان محدودیت‌های اپلیکیشن وب پیروی می‌کند و در یک سند عمومی OpenAPI 3.1 توصیف شده است. کلیدهای تست به شما امکان می‌دهند بدون ارسال ایمیل واقعی و بدون مصرف فضای ذخیره‌سازی، بسازید و تست اجرا کنید.

خواندن راهنمای توسعه‌دهندگان

یک REST API با توصیف OpenAPI 3.1

همهٔ endpointها زیر /api/v1 قرار دارند و با JSON کار می‌کنند. احراز هویت با یک کلید API در هدر Authorization به‌صورت توکن Bearer انجام می‌شود. کلیدها در داشبورد ساخته می‌شوند، فقط یک بار نمایش داده می‌شوند و می‌توان آن‌ها را به فقط‌خواندنی، خواندن و نوشتن، یا دسترسی کامل محدود کرد؛ پس یک اسکریپت گزارش‌گیری هیچ‌وقت اجازهٔ حذف انتقال‌ها را نمی‌گیرد. کل API در یک سند ماشین‌خوان OpenAPI 3.1 در /api/v1/openapi.json توصیف شده که می‌توانید آن را در Postman بارگذاری کنید، از روی آن کلاینت بسازید یا به یک دستیار کدنویسی هوش مصنوعی بدهید. راهنمای توسعه‌دهندگان در /developers مفاهیم را توضیح می‌دهد و مرجع API در /developers/api همهٔ endpointها را با مثال فهرست می‌کند. هر پاسخ یک شناسهٔ درخواست دارد، محدودیت‌های نرخ در هدرهای RateLimit گزارش می‌شوند، فهرست‌ها از صفحه‌بندی مبتنی بر cursor استفاده می‌کنند و همهٔ خطاها یک قالب JSON یکسان دارند.

آپلود قابل ادامه با tus

فایل‌های بزرگ و شبکه‌های ناپایدار با یک درخواست HTTP طولانی به‌خوبی کنار نمی‌آیند. برای ارسال فایل، ابتدا با POST /api/v1/transfers یک انتقال می‌سازید و فهرست فایل‌ها، عنوان، پیام و در صورت تمایل نشانی ایمیل گیرندگان را مشخص می‌کنید. سپس هر فایل با tus، پروتکل باز برای آپلود قابل ادامه، آپلود می‌شود؛ پس اتصال قطع‌شده یا سروری که دوباره راه‌اندازی شده می‌تواند از آخرین بایت ادامه دهد، نه از اول. کلاینت‌های آمادهٔ tus برای JavaScript، Python، Go، Java، .NET، Swift و زبان‌های دیگر وجود دارند. وقتی همهٔ فایل‌ها آپلود شدند، complete را فراخوانی می‌کنید و انتقال به یک لینک عادی Pandafile با صفحهٔ دانلود، لینک‌های شخصی برای گیرندگان، یادآوری‌ها و تاریخ انقضا تبدیل می‌شود. همان محدودیت‌های پلن در مرورگر اینجا هم اعمال می‌شود: در Pro تا 1000 GB در هر انتقال و 1500 GB فضای ذخیره‌سازی.

ارسال فایل مستقیماً از یک URL

گاهی فایل از قبل جای دیگری است: پیوست یک CRM، خروجی یک رندرفارم یا فایلی که روی سرور دیگری export شده است. POST /api/v1/transfers/from-url نشانی‌های HTTPS را می‌گیرد و Pandafile فایل‌ها را برایتان دریافت می‌کند، سپس انتقال را می‌سازد و کامل می‌کند. درخواست تا 20 ثانیه منتظر می‌ماند. واردکردن‌های کوچک کامل‌شده برمی‌گردند و موارد بزرگ‌تر بلافاصله با وضعیت uploading برمی‌گردند، در حالی که واردکردن در پس‌زمینه ادامه دارد. می‌توانید پیشرفت را با GET /api/v1/transfers/{id}/import دنبال کنید یا فقط منتظر webhook transfer.ready بمانید. یکپارچه‌سازی‌های Zapier و Make هم به همین روش فایل می‌فرستند، بدون اینکه گردش‌کار شما مجبور باشد اول آن‌ها را دانلود کند.

Webhookها و اعلان‌ها

به‌جای پرس‌وجوی مکرر، در رویدادها مشترک شوید. Pandafile می‌تواند نشانی URL شما را فراخوانی کند وقتی یک انتقال آماده، دانلود یا منقضی می‌شود، وقتی گیرنده‌ای فایل‌ها را تأیید می‌کند یا درخواست تغییر می‌دهد، وقتی کسی در یکی از درخواست‌های فایل شما آپلود می‌کند و وقتی یک درخواست امضا تکمیل می‌شود. هر تحویل با HMAC-SHA256 در هدر Pandafile-Signature امضا می‌شود تا بتوانید بررسی کنید واقعاً از طرف ما آمده است، و تحویل‌های ناموفق پس از 1 دقیقه، 5 دقیقه، 30 دقیقه، 2 ساعت و 12 ساعت دوباره تلاش می‌شوند. رویدادها همچنین 30 روز نگه داشته می‌شوند و می‌توان آن‌ها را با GET /api/v1/events خواند. اگر اصلاً به کد نیاز ندارید، همین رویدادها می‌توانند در Slack، Microsoft Teams یا Discord پیام بگذارند.

کلیدهای تست، تلاش مجدد امن و دیگر کارهایی که می‌توانید خودکار کنید

کلیدهای API دو حالت دارند. کلیدهای live با pf_live_ و کلیدهای تست با pf_test_ شروع می‌شوند. انتقال‌هایی که با کلید تست ساخته می‌شوند هرگز ایمیل نمی‌فرستند، در فضای ذخیره‌سازی یا میزان مصرف شما حساب نمی‌شوند، فقط 24 ساعت نگه داشته می‌شوند و در فهرست عادی انتقال‌هایتان نشان داده نمی‌شوند؛ پس می‌توانید تست‌های یکپارچه‌سازی را بدون عوارض جانبی روی API واقعی اجرا کنید. درخواست‌های POST و PATCH هدر Idempotency-Key را می‌پذیرند، پس درخواستی که دوباره ارسال شود هرگز انتقال دومی نمی‌سازد. فراتر از انتقال‌ها، API گیرندگان و یادآوری‌ها، تاریخچهٔ دانلود، آمار لینک و تأییدها، درخواست‌های فایل، درخواست‌های امضا، برندینگ و دعوت‌های تیم را هم پوشش می‌دهد. API در Pro از ماهانه $5.99 یا سالانه $49.99 و در Team از ماهانه $14.99 یا سالانه $129.99 گنجانده شده است. در یک تیم، هر عضو کلیدهای شخصی خودش را دارد.

سؤالات

آیا Pandafile یک API دارد؟

بله. Pandafile یک REST API زیر /api/v1 دارد برای ساخت انتقال، آپلود فایل، مدیریت گیرندگان، درخواست‌های فایل و درخواست‌های امضا و دریافت webhook. این API در پلن‌های Pro و Team گنجانده شده است.

مستندات API کجاست؟

راهنمای توسعه‌دهندگان در /developers و مرجع کامل API با مثال در /developers/api قرار دارد. سند ماشین‌خوان OpenAPI 3.1 به‌صورت عمومی در /api/v1/openapi.json در دسترس است.

اگر اتصال قطع شود، آپلود ادامه پیدا می‌کند؟

بله. فایل‌ها با پروتکل tus برای آپلود قابل ادامه آپلود می‌شوند، پس آپلودِ قطع‌شده به‌جای شروع دوباره، از همان جایی که متوقف شده بود ادامه می‌یابد.

آیا می‌توانم بدون ارسال ایمیل واقعی تست کنم؟

بله. از کلید تستی استفاده کنید که با pf_test_ شروع می‌شود. انتقال‌های تست هرگز ایمیل نمی‌فرستند، در فضای ذخیره‌سازی یا میزان مصرف شما حساب نمی‌شوند و پس از 24 ساعت حذف می‌شوند.

آیا می‌توانم فایلی را که از قبل آنلاین است بفرستم؟

بله. POST /api/v1/transfers/from-url فایل‌ها را از نشانی‌های HTTPS دریافت می‌کند و آن‌ها را به یک انتقال تبدیل می‌کند. واردکردن‌های بزرگ‌تر در پس‌زمینه ادامه می‌یابند و webhook transfer.ready به شما خبر می‌دهد که لینک آماده است.

خواندن راهنمای توسعه‌دهندگان

محبوب