مفاتيح API والصلاحيات ووضع الاختبار
الجواب المختصر
في Pro وTeam أنشئ مفاتيح API من «لوحة التحكم» > «النطاق وAPI». لكل مفتاح صلاحيات («قراءة فقط» أو «قراءة وكتابة» أو «وصول كامل») ووضع: المفاتيح الفعلية (pf_live_) تعمل حقيقةً، والمفاتيح التجريبية (pf_test_) لا ترسل بريدًا لأحد وتنتهي عمليات النقل الخاصة بها بعد 24 ساعة.
يتيح Pandafile API لتطبيقاتك ونصوصك البرمجية وخوادمك إرسال الملفات وجمع الملفات المرفوعة وطلب التوقيعات. وهو مضمَّن في 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 شخصية: ينشئ كل عضو مفاتيحه الخاصة.