Pandafile · 50 GB בחינם בכל שבוע

API להעברת קבצים לאפליקציות ולתהליכי העבודה שלכם

ל-Pandafile יש REST API לשליחת קבצים גדולים מהקוד, מהשרתים ומכלי ה-no-code שלכם. צרו העברה, העלו קבצים בהעלאות ניתנות להמשך, שלחו קישורים אישיים לנמענים במייל וקבלו webhook כשמישהו מוריד. ה-API הוא חלק מ-Pro ו-Team, פועל לפי אותן מגבלות כמו אפליקציית הרשת, ומתואר במסמך OpenAPI 3.1 ציבורי. מפתחות בדיקה מאפשרים לבנות ולהריץ בדיקות בלי לשלוח מיילים אמיתיים ובלי לנצל את האחסון שלכם.

לקריאת מדריך המפתחים

REST API עם תיאור OpenAPI 3.1

כל נקודות הקצה נמצאות תחת /api/v1 ומדברות JSON. האימות נעשה עם מפתח API בכותרת Authorization כטוקן Bearer. מפתחות נוצרים בלוח הבקרה, מוצגים פעם אחת בלבד, ואפשר להגביל אותם לקריאה בלבד, לקריאה וכתיבה או לגישה מלאה, כך שסקריפט דוחות אף פעם לא מקבל הרשאה למחוק העברות. ה-API כולו מתואר במסמך OpenAPI 3.1 קריא למכונה בכתובת /api/v1/openapi.json, שאפשר לטעון ל-Postman, לייצר ממנו לקוח או למסור לעוזר תכנות מבוסס AI. מדריך המפתחים ב-/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 שעות בלבד ולא מופיעות ברשימת ההעברות הרגילה, כך שאפשר להריץ בדיקות אינטגרציה מול ה-API האמיתי בלי תופעות לוואי. בקשות POST ו-PATCH מקבלות כותרת Idempotency-Key, כך שבקשה שנשלחה שוב אף פעם לא יוצרת העברה שנייה. מעבר להעברות, ה-API מכסה נמענים ותזכורות, היסטוריית הורדות, סטטיסטיקת קישורים ואישורים, בקשות קבצים, בקשות חתימה, מיתוג והזמנות לצוות. ה-API כלול ב-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 מודיע לכם כשהקישור מוכן.

לקריאת מדריך המפתחים

פופולרי