מפתחות API, הרשאות ומצב בדיקה

4 דק׳ קריאה · עודכן ב-2026-11-15

התשובה הקצרה

ב-Pro וב-Team יוצרים מפתחות API בלוח הבקרה > "דומיין ו-API". לכל מפתח יש הרשאות ("קריאה בלבד", "קריאה וכתיבה" או "גישה מלאה") ומצב: מפתחות חיים (pf_live_) עובדים באמת, ומפתחות בדיקה (pf_test_) לא שולחים מייל לאף אחד, וההעברות שלהם פגות אחרי 24 שעות.

ה-API של Pandafile מאפשר לאפליקציות, לסקריפטים ולשרתים שלכם לשלוח קבצים, לאסוף העלאות ולבקש חתימות. הוא כלול ב-Pro וב-Team ופועל לפי אותן מגבלות כמו האתר. הכול מתחיל במפתח API.

יצירת מפתח

  1. התחברו ופתחו את לוח הבקרה > "דומיין ו-API".
  2. תחת "מפתחות API" תנו למפתח שם, למשל "העלאות מהאתר".
  3. בחרו את מצב המפתח, "חי" או "בדיקה", ואת הרשאות המפתח: "גישה מלאה", "קריאה וכתיבה" או "קריאה בלבד".
  4. לחצו על "יצירת מפתח" והעתיקו את המפתח מיד. מטעמי אבטחה אנחנו מציגים אותו פעם אחת בלבד.
  5. שלחו אותו בכל בקשה בכותרת Authorization: Bearer ואחריה המפתח.

אפשר להחזיק עד 10 מפתחות פעילים. מפתחות חיים מתחילים ב-pf_live_ ומפתחות בדיקה ב-pf_test_. מדריך המפתחים נמצא ב-pandafile.co/developers ותיעוד ה-API ב-pandafile.co/developers/api.

הרשאות: מה מפתח יכול לעשות

  • קריאה בלבד: בקשות GET בלבד. המפתח יכול לבדוק מידע אבל לא לשנות כלום.
  • קריאה וכתיבה: כל מה שיש ב"קריאה בלבד", ובנוסף יצירה, שינוי ומחיקה של העברות, בקשות קבצים, בקשות חתימה ומינויי Webhook.
  • גישה מלאה: הכול, כולל הגדרות חשבון כמו מיתוג והזמנות לצוות.

מצב בדיקה

  • העברות שנוצרות עם מפתח pf_test_ הן נתוני בדיקה. אף אחד לא מקבל מייל אף פעם, גם לא נמענים שאתם מוסיפים.
  • העברות בדיקה תמיד פגות 24 שעות אחרי שנוצרו, ואי אפשר להאריך אותן.
  • הן לא נספרות באף מגבלה, אחסון או שימוש, ולא מופיעות ברשימות ההעברות הרגילות.
  • באירועי Webhook שלהן livemode הוא false, והם אף פעם לא נשלחים ל-Slack, ‏Microsoft Teams או Discord.
  • כמה פעולות עובדות רק עם מפתח חי. עם מפתח בדיקה ה-API עונה אז בשגיאה test_mode_unsupported.

שמירה על המפתחות

  • כל מי שיש לו מפתח יכול לשלוח קבצים מהחשבון שלכם. שמרו מפתחות בשרת, אף פעם לא בקוד הציבורי של אתר או אפליקציה.
  • בטלו מפתח בלוח הבקרה > "דומיין ו-API" אם ייתכן שהוא דלף. אפליקציות שמשתמשות בו מפסיקות לעבוד מיד, וגם מינויי Webhook שנוצרו איתו, למשל דרך Zapier או Make, נעצרים.
  • לכל מפתח יש מגבלת קצב משלו. כל תגובה מראה איפה אתם עומדים בכותרות RateLimit.
  • בצוות, מפתחות API הם אישיים: כל חבר יוצר מפתחות משלו.
מוכנים לשלוח?

עד 50 GB בחינם בהעברה, בלי צורך בחשבון.

שליחת קבצים