מפתחות API, הרשאות ומצב בדיקה
התשובה הקצרה
ב-Pro וב-Team יוצרים מפתחות API בלוח הבקרה > "דומיין ו-API". לכל מפתח יש הרשאות ("קריאה בלבד", "קריאה וכתיבה" או "גישה מלאה") ומצב: מפתחות חיים (pf_live_) עובדים באמת, ומפתחות בדיקה (pf_test_) לא שולחים מייל לאף אחד, וההעברות שלהם פגות אחרי 24 שעות.
ה-API של Pandafile מאפשר לאפליקציות, לסקריפטים ולשרתים שלכם לשלוח קבצים, לאסוף העלאות ולבקש חתימות. הוא כלול ב-Pro וב-Team ופועל לפי אותן מגבלות כמו האתר. הכול מתחיל במפתח API.
יצירת מפתח
- התחברו ופתחו את לוח הבקרה > "דומיין ו-API".
- תחת "מפתחות API" תנו למפתח שם, למשל "העלאות מהאתר".
- בחרו את מצב המפתח, "חי" או "בדיקה", ואת הרשאות המפתח: "גישה מלאה", "קריאה וכתיבה" או "קריאה בלבד".
- לחצו על "יצירת מפתח" והעתיקו את המפתח מיד. מטעמי אבטחה אנחנו מציגים אותו פעם אחת בלבד.
- שלחו אותו בכל בקשה בכותרת 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 הם אישיים: כל חבר יוצר מפתחות משלו.