کلیدهای API، دامنهٔ دسترسی و حالت آزمایشی
پاسخ کوتاه
در Pro و Team کلیدهای API را در داشبورد > دامنه و API بسازید. هر کلید یک دامنهٔ دسترسی (فقط خواندن، خواندن و نوشتن یا دسترسی کامل) و یک حالت دارد: کلیدهای واقعی (pf_live_) واقعاً کار میکنند، کلیدهای آزمایشی (pf_test_) هرگز به کسی ایمیل نمیزنند و انتقالهایشان بعد از 24 ساعت منقضی میشوند.
API Pandafile به برنامهها، اسکریپتها و سرورهای خودتان امکان میدهد فایل بفرستند، آپلود جمع کنند و امضا درخواست کنند. این API در Pro و Team گنجانده شده و همان محدودیتهای وبسایت را دارد. همهچیز با یک کلید API شروع میشود.
یک کلید بسازید
- وارد شوید و داشبورد > دامنه و API را باز کنید.
- زیر «کلیدهای API» برای کلید نامی بگذارید، مثلاً «آپلودهای وبسایت».
- حالت کلید را انتخاب کنید، «واقعی» یا «آزمایشی»، و دسترسی کلید را: «دسترسی کامل»، «خواندن و نوشتن» یا «فقط خواندن».
- «ساخت کلید» را بزنید و کلید را فوراً کپی کنید. برای امنیت شما فقط یک بار نمایشش میدهیم.
- آن را در هر درخواست در هدر Authorization: Bearer و بعد از آن خود کلید بفرستید.
حداکثر 10 کلید فعال میتوانید داشته باشید. کلیدهای واقعی با pf_live_ و کلیدهای آزمایشی با pf_test_ شروع میشوند. راهنمای توسعهدهنده در pandafile.co/developers و مرجع API در pandafile.co/developers/api است.
دامنهٔ دسترسی: هر کلید چه کاری میتواند بکند
- فقط خواندن: فقط درخواستهای GET. کلید میتواند چیزها را ببیند ولی چیزی را تغییر نمیدهد.
- خواندن و نوشتن: همهٔ موارد «فقط خواندن»، بهعلاوهٔ ساختن، تغییر دادن و حذف انتقالها، درخواستهای فایل، درخواستهای امضا و اشتراکهای وبهوک.
- دسترسی کامل: همهچیز، از جمله تنظیمات حساب مثل برندینگ و دعوتهای تیم.
حالت آزمایشی
- انتقالهایی که با کلید pf_test_ ساخته میشوند دادهٔ آزمایشی هستند. هرگز به کسی ایمیل زده نمیشود، حتی به گیرندههایی که اضافه میکنید.
- انتقالهای آزمایشی همیشه 24 ساعت بعد از ساخته شدن منقضی میشوند و قابل تمدید نیستند.
- آنها در هیچ محدودیت، فضای ذخیرهسازی یا مصرفی حساب نمیشوند و در فهرستهای معمول انتقالهایتان نمایش داده نمیشوند.
- رویدادهای وبهوک مربوط به آنها livemode برابر false دارند و هرگز به Slack، Microsoft Teams یا Discord نمیروند.
- چند کار فقط با کلید واقعی انجام میشود. با کلید آزمایشی، API در این موارد خطای test_mode_unsupported برمیگرداند.
کلیدها را امن نگه دارید
- هر کسی که کلید را داشته باشد میتواند از حساب شما فایل بفرستد. کلیدها را روی سرورتان نگه دارید، هرگز در کد عمومی یک وبسایت یا برنامه.
- اگر ممکن است کلیدی لو رفته باشد، آن را در داشبورد > دامنه و API باطل کنید. برنامههایی که از آن استفاده میکنند فوراً از کار میافتند و اشتراکهای وبهوکی که با آن ساخته شدهاند، مثلاً توسط Zapier یا Make، هم متوقف میشوند.
- هر کلید محدودیت نرخ درخواست خودش را دارد. هر پاسخ در هدرهای RateLimit نشان میدهد در چه وضعیتی هستید.
- در یک تیم، کلیدهای API شخصیاند: هر عضو کلیدهای خودش را میسازد.