Pandafile · 50 غيغابايت مجانًا كل أسبوع

واجهة API لنقل الملفات لتطبيقاتك وسير عملك

يوفر Pandafile واجهة REST API لإرسال الملفات الكبيرة من شيفرتك وخوادمك وأدوات العمل دون برمجة. أنشئ إرسالًا، وارفع الملفات برفع قابل للاستئناف، وأرسل روابط شخصية إلى المستلمين بالبريد الإلكتروني، واستقبل webhook عندما يحمّل أحدهم. الواجهة جزء من Pro وTeam، وتخضع للحدود نفسها التي يخضع لها تطبيق الويب، وموصوفة في مستند OpenAPI 3.1 عام. وتتيح لك مفاتيح الاختبار البناء وتشغيل الاختبارات دون إرسال رسائل بريد حقيقية أو استهلاك مساحة التخزين.

اقرأ دليل المطورين

واجهة REST مع وصف OpenAPI 3.1

تقع كل نقاط النهاية تحت /api/v1 وتتعامل بصيغة JSON. تتم المصادقة بمفتاح API في ترويسة Authorization كرمز Bearer. تُنشأ المفاتيح في لوحة التحكم، وتُعرض مرة واحدة فقط، ويمكن حصر صلاحياتها في القراءة فقط، أو القراءة والكتابة، أو الوصول الكامل، فلا يحصل سكربت تقارير أبدًا على صلاحية حذف الإرسالات. الواجهة كلها موصوفة في مستند OpenAPI 3.1 قابل للقراءة آليًا على /api/v1/openapi.json، يمكنك تحميله في Postman أو توليد عميل منه أو تسليمه لمساعد برمجة بالذكاء الاصطناعي. يشرح دليل المطورين على /developers المفاهيم، ويسرد مرجع API على /developers/api كل نقطة نهاية مع أمثلة. تحمل كل استجابة معرّف طلب، وتظهر حدود المعدل في ترويسات RateLimit، وتستخدم القوائم ترقيم الصفحات بالمؤشر، وتشترك الأخطاء في صيغة JSON واحدة.

رفع قابل للاستئناف عبر tus

الملفات الكبيرة والشبكات غير المستقرة لا تنسجم مع طلب HTTP واحد طويل. لإرسال الملفات، تنشئ أولًا إرسالًا عبر POST /api/v1/transfers، مع قائمة الملفات والعنوان والرسالة، وعناوين بريد المستلمين إن أردت. ثم يُرفع كل ملف عبر tus، البروتوكول المفتوح للرفع القابل للاستئناف، فيستطيع الاتصال المنقطع أو الخادم المعاد تشغيله المتابعة من آخر بايت بدل البدء من جديد. وتتوفر عملاء tus جاهزة للغات JavaScript وPython وGo وJava و.NET وSwift وغيرها. وعندما تكتمل كل الملفات، تستدعي complete، فيصبح الإرسال رابط Pandafile عاديًا بصفحة تحميل وروابط شخصية للمستلمين وتذكيرات وتاريخ انتهاء صلاحية. وتنطبق حدود الخطة نفسها كما في المتصفح: حتى 1000 GB في الإرسال الواحد و1500 GB من مساحة التخزين في Pro.

أرسل الملفات مباشرة من رابط URL

أحيانًا يكون الملف موجودًا في مكان آخر بالفعل: مرفق في نظام CRM، أو مخرجات مزرعة تصيير، أو ملف مُصدَّر على خادم آخر. تستقبل POST /api/v1/transfers/from-url روابط HTTPS ويجلب Pandafile الملفات نيابة عنك، ثم ينشئ الإرسال ويكمله. ينتظر الطلب حتى 20 ثانية. تعود عمليات الاستيراد الصغيرة مكتملة، أما الكبيرة فتعود فورًا بالحالة uploading بينما يستمر الاستيراد في الخلفية. يمكنك متابعة التقدم عبر GET /api/v1/transfers/{id}/import، أو ببساطة انتظار حدث webhook المسمّى transfer.ready. وبهذه الطريقة أيضًا ترسل تكاملات Zapier وMake الملفات دون أن يضطر سير عملك إلى تحميلها أولًا.

Webhooks والإشعارات

بدل الاستعلام المتكرر، اشترك في الأحداث. يستطيع Pandafile استدعاء عنوان URL الخاص بك عندما يصبح الإرسال جاهزًا أو يُحمَّل أو تنتهي صلاحيته، وعندما يوافق مستلم على الملفات أو يطلب تعديلات، وعندما يرفع أحدهم ملفات إلى أحد طلبات الملفات الخاصة بك، وعندما يكتمل طلب توقيع. كل عملية تسليم موقّعة بـ HMAC-SHA256 في ترويسة Pandafile-Signature، فتستطيع التحقق من أنها جاءت منا فعلًا، وتُعاد محاولة التسليمات الفاشلة بعد دقيقة واحدة، و5 دقائق، و30 دقيقة، وساعتين، و12 ساعة. وتُحفظ الأحداث أيضًا لمدة 30 يومًا ويمكن قراءتها عبر GET /api/v1/events. وإذا لم تكن بحاجة إلى شيفرة إطلاقًا، فيمكن للأحداث نفسها نشر رسائل في Slack أو Microsoft Teams أو Discord.

مفاتيح الاختبار، وإعادة المحاولة الآمنة، وما يمكنك أتمتته أيضًا

تأتي مفاتيح API بوضعين. تبدأ المفاتيح الحية بـ pf_live_ ومفاتيح الاختبار بـ pf_test_. الإرسالات التي تُنشأ بمفتاح اختبار لا ترسل رسائل بريد أبدًا، ولا تُحتسب من مساحة التخزين أو الاستخدام، وتُحفظ 24 ساعة فقط، ولا تظهر في قائمة إرسالاتك العادية، فتستطيع تشغيل اختبارات التكامل على الواجهة الحقيقية دون آثار جانبية. وتقبل طلبات POST وPATCH ترويسة Idempotency-Key، فلا يُنشئ الطلب المعاد إرسالًا ثانيًا أبدًا. وإلى جانب الإرسالات، تغطي الواجهة المستلمين والتذكيرات، وسجل التحميل، وإحصائيات الروابط والموافقات، وطلبات الملفات، وطلبات التوقيع، والهوية، ودعوات الفريق. الواجهة مضمّنة في Pro بدءًا من $5.99 شهريًا أو $49.99 سنويًا، وفي Team بدءًا من $14.99 شهريًا أو $129.99 سنويًا. وفي الفريق، لكل عضو مفاتيحه الشخصية.

أسئلة

هل لدى Pandafile واجهة API؟

نعم. لدى Pandafile واجهة REST API تحت /api/v1 لإنشاء الإرسالات ورفع الملفات وإدارة المستلمين وطلبات الملفات وطلبات التوقيع واستقبال webhooks. وهي مضمّنة في خطتي 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 عندما يصبح الرابط جاهزًا.

اقرأ دليل المطورين

الأكثر شيوعًا