Pandafile · हर हफ़्ते 50 GB मुफ़्त

आपके ऐप और वर्कफ़्लो के लिए फाइल ट्रांसफर API

Pandafile में एक REST API है, जिससे आप अपने कोड, सर्वर और नो-कोड टूल से बड़ी फाइलें भेज सकते हैं। ट्रांसफर बनाएं, रिज़्यूमेबल अपलोड से फाइलें अपलोड करें, पाने वालों को निजी लिंक ईमेल करें और किसी के डाउनलोड करने पर वेबहुक पाएं। API, Pro और Team का हिस्सा है, वेब ऐप जैसी ही सीमाएं मानता है, और एक पब्लिक OpenAPI 3.1 दस्तावेज़ में बताया गया है। टेस्ट की की मदद से आप असली ईमेल भेजे बिना और अपना स्टोरेज इस्तेमाल किए बिना इंटीग्रेशन बना और टेस्ट कर सकते हैं।

डेवलपर गाइड पढ़ें

OpenAPI 3.1 विवरण के साथ REST API

हर एंडपॉइंट /api/v1 के तहत है और JSON में बात करता है। आप Authorization हेडर में Bearer टोकन के रूप में API की से ऑथेंटिकेट करते हैं। की आपके डैशबोर्ड में बनती हैं, सिर्फ एक बार दिखाई जाती हैं, और उन्हें सिर्फ पढ़ने, पढ़ने और लिखने, या पूरे एक्सेस तक सीमित किया जा सकता है, ताकि किसी रिपोर्टिंग स्क्रिप्ट को कभी ट्रांसफर डिलीट करने की ताकत न मिले। पूरा API /api/v1/openapi.json पर मशीन से पढ़े जा सकने वाले OpenAPI 3.1 दस्तावेज़ में है, जिसे आप Postman में लोड कर सकते हैं, उससे क्लाइंट जनरेट कर सकते हैं या किसी AI कोडिंग असिस्टेंट को दे सकते हैं। /developers पर डेवलपर गाइड कॉन्सेप्ट समझाती है, और /developers/api पर API रेफरेंस हर एंडपॉइंट उदाहरणों के साथ दिखाता है। हर रिस्पॉन्स में एक रिक्वेस्ट ID होती है, रेट लिमिट RateLimit हेडर में बताई जाती हैं, लिस्ट कर्सर पेजिनेशन इस्तेमाल करती हैं, और सभी एरर एक ही JSON फॉर्मेट में आते हैं।

tus के साथ रिज़्यूमेबल अपलोड

बड़ी फाइलें और कमज़ोर नेटवर्क एक लंबी HTTP रिक्वेस्ट के साथ ठीक से नहीं चलते। फाइलें भेजने के लिए आप पहले POST /api/v1/transfers से ट्रांसफर बनाते हैं, जिसमें फाइलों की लिस्ट, टाइटल, मैसेज और चाहें तो पाने वालों के ईमेल पते होते हैं। फिर हर फाइल tus से अपलोड होती है, जो रिज़्यूमेबल अपलोड का ओपन प्रोटोकॉल है, इसलिए कनेक्शन टूटने या सर्वर रीस्टार्ट होने पर अपलोड शुरू से नहीं, आखिरी बाइट से आगे बढ़ता है। JavaScript, Python, Go, Java, .NET, Swift और कई दूसरी भाषाओं के लिए तैयार tus क्लाइंट मौजूद हैं। सारी फाइलें आ जाने पर आप complete कॉल करते हैं, और ट्रांसफर एक सामान्य Pandafile लिंक बन जाता है, जिसमें डाउनलोड पेज, पाने वालों के लिए निजी लिंक, रिमाइंडर और एक्सपायरी होती है। ब्राउज़र जैसी ही प्लान सीमाएं लागू होती हैं: Pro पर हर ट्रांसफर में 1000 GB तक और 1500 GB स्टोरेज।

फाइलें सीधे URL से भेजें

कभी-कभी फाइल पहले से कहीं और होती है: CRM का अटैचमेंट, रेंडर फ़ार्म का आउटपुट या किसी दूसरे सर्वर पर एक्सपोर्ट। POST /api/v1/transfers/from-url, HTTPS URL लेता है और Pandafile को आपके लिए फाइलें लाने देता है, फिर ट्रांसफर बनाकर पूरा करता है। रिक्वेस्ट 20 सेकंड तक इंतज़ार करती है। छोटे इम्पोर्ट पूरे होकर लौटते हैं, और बड़े इम्पोर्ट तुरंत uploading स्टेटस के साथ लौटते हैं, जबकि इम्पोर्ट बैकग्राउंड में चलता रहता है। आप GET /api/v1/transfers/{id}/import से प्रगति देख सकते हैं, या बस transfer.ready वेबहुक का इंतज़ार कर सकते हैं। Zapier और Make इंटीग्रेशन भी इसी तरह फाइलें भेजते हैं, ताकि आपके वर्कफ़्लो को पहले उन्हें डाउनलोड न करना पड़े।

वेबहुक और सूचनाएं

बार-बार पूछने (polling) के बजाय इवेंट्स को सब्सक्राइब करें। Pandafile आपके URL को तब कॉल कर सकता है जब कोई ट्रांसफर तैयार, डाउनलोड या एक्सपायर हो, जब कोई पाने वाला फाइलें मंज़ूर करे या बदलाव मांगे, जब कोई आपकी किसी फाइल रिक्वेस्ट पर अपलोड करे और जब कोई सिग्नेचर अनुरोध पूरा हो। हर डिलीवरी Pandafile-Signature हेडर में HMAC-SHA256 से साइन होती है, ताकि आप जांच सकें कि वह सच में हमसे आई है, और फेल हुई डिलीवरी 1 मिनट, 5 मिनट, 30 मिनट, 2 घंटे और 12 घंटे बाद दोबारा भेजी जाती है। इवेंट्स 30 दिन तक रखे जाते हैं और GET /api/v1/events से पढ़े जा सकते हैं। अगर आपको कोड बिल्कुल नहीं चाहिए, तो यही इवेंट्स Slack, Microsoft Teams या Discord में मैसेज भेज सकते हैं।

टेस्ट की, सुरक्षित रीट्राई और आप और क्या ऑटोमेट कर सकते हैं

API की दो मोड में आती हैं। लाइव की pf_live_ से और टेस्ट की pf_test_ से शुरू होती हैं। टेस्ट की से बने ट्रांसफर कभी ईमेल नहीं भेजते, आपके स्टोरेज या इस्तेमाल में नहीं गिने जाते, सिर्फ 24 घंटे रखे जाते हैं और आपकी सामान्य ट्रांसफर लिस्ट में नहीं दिखते, इसलिए आप असली API पर बिना किसी साइड इफ़ेक्ट के इंटीग्रेशन टेस्ट चला सकते हैं। POST और PATCH रिक्वेस्ट Idempotency-Key हेडर स्वीकार करती हैं, इसलिए दोबारा भेजी गई रिक्वेस्ट कभी दूसरा ट्रांसफर नहीं बनाती। ट्रांसफर के अलावा API में पाने वाले और रिमाइंडर, डाउनलोड हिस्ट्री, लिंक के आंकड़े और मंज़ूरियां, फाइल रिक्वेस्ट, सिग्नेचर अनुरोध, ब्रांडिंग और टीम इनवाइट शामिल हैं। API, Pro में शामिल है, $5.99 प्रति माह या $49.99 प्रति वर्ष से, और Team में, $14.99 प्रति माह या $129.99 प्रति वर्ष से। टीम में हर सदस्य की अपनी निजी की होती हैं।

सवाल

क्या Pandafile का API है?

हां। Pandafile का /api/v1 के तहत REST API है, जिससे ट्रांसफर बनाए जा सकते हैं, फाइलें अपलोड की जा सकती हैं, पाने वाले, फाइल रिक्वेस्ट और सिग्नेचर अनुरोध मैनेज किए जा सकते हैं और वेबहुक पाए जा सकते हैं। यह Pro और Team प्लान में शामिल है।

API डॉक्यूमेंटेशन कहां है?

डेवलपर गाइड /developers पर है और उदाहरणों के साथ पूरा API रेफरेंस /developers/api पर। मशीन से पढ़ा जा सकने वाला OpenAPI 3.1 दस्तावेज़ /api/v1/openapi.json पर सबके लिए उपलब्ध है।

क्या कनेक्शन टूटने पर अपलोड फिर से शुरू हो सकते हैं?

हां। फाइलें रिज़्यूमेबल अपलोड के tus प्रोटोकॉल से अपलोड होती हैं, इसलिए रुका हुआ अपलोड शुरू से नहीं, वहीं से आगे बढ़ता है जहां रुका था।

क्या मैं असली ईमेल भेजे बिना टेस्ट कर सकता हूं?

हां। pf_test_ से शुरू होने वाली टेस्ट की इस्तेमाल करें। टेस्ट ट्रांसफर कभी ईमेल नहीं भेजते, आपके स्टोरेज या इस्तेमाल में नहीं गिने जाते, और 24 घंटे बाद डिलीट हो जाते हैं।

क्या मैं ऐसी फाइल भेज सकता हूं जो पहले से ऑनलाइन है?

हां। POST /api/v1/transfers/from-url, HTTPS URL से फाइलें लाकर उन्हें ट्रांसफर में बदल देता है। बड़े इम्पोर्ट बैकग्राउंड में चलते रहते हैं, और transfer.ready वेबहुक बताता है कि लिंक कब तैयार है।

डेवलपर गाइड पढ़ें

लोकप्रिय