کلیدهای API، دامنهٔ دسترسی و حالت آزمایشی

4 دقیقه مطالعه · به‌روزرسانی: 2026-11-15

پاسخ کوتاه

در Pro و Team کلیدهای API را در داشبورد > دامنه و API بسازید. هر کلید یک دامنهٔ دسترسی (فقط خواندن، خواندن و نوشتن یا دسترسی کامل) و یک حالت دارد: کلیدهای واقعی (pf_live_) واقعاً کار می‌کنند، کلیدهای آزمایشی (pf_test_) هرگز به کسی ایمیل نمی‌زنند و انتقال‌هایشان بعد از 24 ساعت منقضی می‌شوند.

API ‏Pandafile به برنامه‌ها، اسکریپت‌ها و سرورهای خودتان امکان می‌دهد فایل بفرستند، آپلود جمع کنند و امضا درخواست کنند. این API در 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. کلید می‌تواند چیزها را ببیند ولی چیزی را تغییر نمی‌دهد.
  • خواندن و نوشتن: همهٔ موارد «فقط خواندن»، به‌علاوهٔ ساختن، تغییر دادن و حذف انتقال‌ها، درخواست‌های فایل، درخواست‌های امضا و اشتراک‌های وب‌هوک.
  • دسترسی کامل: همه‌چیز، از جمله تنظیمات حساب مثل برندینگ و دعوت‌های تیم.

حالت آزمایشی

  • انتقال‌هایی که با کلید pf_test_ ساخته می‌شوند دادهٔ آزمایشی هستند. هرگز به کسی ایمیل زده نمی‌شود، حتی به گیرنده‌هایی که اضافه می‌کنید.
  • انتقال‌های آزمایشی همیشه 24 ساعت بعد از ساخته شدن منقضی می‌شوند و قابل تمدید نیستند.
  • آن‌ها در هیچ محدودیت، فضای ذخیره‌سازی یا مصرفی حساب نمی‌شوند و در فهرست‌های معمول انتقال‌هایتان نمایش داده نمی‌شوند.
  • رویدادهای وب‌هوک مربوط به آن‌ها livemode برابر false دارند و هرگز به Slack، Microsoft Teams یا Discord نمی‌روند.
  • چند کار فقط با کلید واقعی انجام می‌شود. با کلید آزمایشی، API در این موارد خطای test_mode_unsupported برمی‌گرداند.

کلیدها را امن نگه دارید

  • هر کسی که کلید را داشته باشد می‌تواند از حساب شما فایل بفرستد. کلیدها را روی سرورتان نگه دارید، هرگز در کد عمومی یک وب‌سایت یا برنامه.
  • اگر ممکن است کلیدی لو رفته باشد، آن را در داشبورد > دامنه و API باطل کنید. برنامه‌هایی که از آن استفاده می‌کنند فوراً از کار می‌افتند و اشتراک‌های وب‌هوکی که با آن ساخته شده‌اند، مثلاً توسط Zapier یا Make، هم متوقف می‌شوند.
  • هر کلید محدودیت نرخ درخواست خودش را دارد. هر پاسخ در هدرهای RateLimit نشان می‌دهد در چه وضعیتی هستید.
  • در یک تیم، کلیدهای API شخصی‌اند: هر عضو کلیدهای خودش را می‌سازد.
آمادهٔ ارسال هستید؟

تا 50 GB رایگان در هر انتقال، بدون نیاز به حساب کاربری.

ارسال فایل