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 अनुरोध। कुंजी चीज़ें देख सकती है, पर कुछ बदल नहीं सकती।
- पढ़ना और लिखना: "सिर्फ़ पढ़ना" का सब कुछ, साथ में ट्रांसफ़र, फ़ाइल अनुरोध, सिग्नेचर अनुरोध और वेबहुक सब्सक्रिप्शन बनाना, बदलना और हटाना।
- पूरा एक्सेस: सब कुछ, खाते की सेटिंग्स जैसे ब्रांडिंग और टीम इनवाइट भी।
टेस्ट मोड
- pf_test_ कुंजी से बने ट्रांसफ़र टेस्ट डेटा हैं। किसी को कभी ईमेल नहीं जाता, आपके जोड़े गए पाने वालों को भी नहीं।
- टेस्ट ट्रांसफ़र बनने के 24 घंटे बाद हमेशा एक्सपायर हो जाते हैं और बढ़ाए नहीं जा सकते।
- ये किसी सीमा, स्टोरेज या इस्तेमाल में नहीं गिने जाते, और आपकी सामान्य ट्रांसफ़र सूचियों में नहीं दिखते।
- इनके वेबहुक इवेंट में livemode false होता है, और ये कभी Slack, Microsoft Teams या Discord पर नहीं जाते।
- कुछ काम सिर्फ़ लाइव कुंजी से होते हैं। टेस्ट कुंजी से करने पर API test_mode_unsupported एरर देता है।
कुंजियाँ सुरक्षित रखें
- जिसके पास कुंजी है, वह आपके खाते से फ़ाइलें भेज सकता है। कुंजियाँ अपने सर्वर पर रखें, किसी वेबसाइट या ऐप के सार्वजनिक कोड में कभी नहीं।
- अगर कोई कुंजी लीक हुई हो सकती है, तो उसे डैशबोर्ड > डोमेन और API में रद्द करें। उसे इस्तेमाल करने वाले ऐप तुरंत काम करना बंद कर देते हैं, और उससे बने वेबहुक सब्सक्रिप्शन, जैसे Zapier या Make के, भी रुक जाते हैं।
- हर कुंजी की अपनी रेट लिमिट होती है। हर जवाब RateLimit हेडर में बताता है कि आप कहाँ हैं।
- टीम में API कुंजियाँ निजी होती हैं: हर सदस्य अपनी कुंजियाँ ख़ुद बनाता है।