FAQ

IPFS Ninja के बारे में अक्सर पूछे जाने वाले प्रश्न।

सामान्य

IPFS Ninja क्या है?

IPFS Ninja एक प्रबंधित IPFS पिनिंग सेवा है। आप एक सरल REST API के माध्यम से कोई भी फ़ाइल अपलोड करते हैं, या IPFS नेटवर्क से मौजूदा CID पिन करते हैं। प्रत्येक फ़ाइल को एक स्थायी content identifier (CID) मिलता है और यह हमारे gateway पर ipfs.ninja/ipfs/<CID> के माध्यम से सुलभ होता है।

कौन से फ़ाइल प्रकार समर्थित हैं?

सभी फ़ाइल प्रकार समर्थित हैं। JSON ऑब्जेक्ट और एरे सीधे भेजे जा सकते हैं। अन्य सभी फ़ाइलें (इमेज, PDF, HTML, वीडियो, ऑडियो, बाइनरी) base64-एन्कोडेड कंटेंट के रूप में भेजी जाती हैं।

क्या फ़ाइल आकार की सीमा है?

व्यक्तिगत अपलोड आपके प्लान के स्टोरेज आवंटन द्वारा सीमित हैं। आपके उपलब्ध स्टोरेज से परे कोई प्रति-फ़ाइल आकार सीमा नहीं है।

क्या मैं IPFS पर पहले से मौजूद कंटेंट को पिन कर सकता हूं?

हां। किसी भी वैध CID के साथ POST /pin का उपयोग करें। हमारा क्लस्टर IPFS नेटवर्क से कंटेंट लाएगा और इसे आपके खाते में पिन करेगा। विवरण के लिए Pinning API दस्तावेज़ देखें।

पिनिंग में कितना समय लगता है?

यह फ़ाइल के आकार और कितने IPFS नोड्स के पास कंटेंट है, इस पर निर्भर करता है। छोटी, अच्छी तरह वितरित फ़ाइलें सेकंडों में पिन हो जाती हैं। बड़ा या शायद ही कभी पिन किया गया कंटेंट कुछ मिनट ले सकता है। पिन endpoint तुरंत pinning स्थिति के साथ लौटता है — प्रगति जांचने के लिए GET /pin/:cid का उपयोग करें।

यदि CID नहीं मिल सकता तो क्या होता है?

स्थिति failed में बदल जाती है। इसका मतलब है कि CID अमान्य है या कंटेंट किसी भी पहुंच योग्य IPFS नोड पर उपलब्ध नहीं है।

क्या IPFS पर अपलोड किया गया डेटा सार्वजनिक है?

हां। IPFS पर पिन किया गया सभी कंटेंट किसी भी IPFS gateway के माध्यम से इसके CID द्वारा सार्वजनिक रूप से सुलभ है। यदि आपको निजी एक्सेस चाहिए, तो token-required मोड के साथ समर्पित gateway का उपयोग करें — यह आपके gateway के माध्यम से एक्सेस को प्रतिबंधित करता है, हालांकि कंटेंट व्यापक IPFS नेटवर्क पर उपलब्ध रहता है।

यदि मैं अपना खाता रद्द कर दूं तो क्या मेरी फ़ाइलें IPFS पर रहेंगी?

रद्द करने पर हम आपकी फ़ाइलों को अपने नोड्स से अनपिन करते हैं। यदि अन्य IPFS नोड्स ने आपका कंटेंट कैश किया है, तो यह सुलभ रह सकता है। हालांकि, सक्रिय पिनिंग के बिना, फ़ाइलें अंततः नेटवर्क में garbage collection द्वारा हटा दी जाएंगी।

प्रमाणीकरण और API

मैं API अनुरोधों को कैसे प्रमाणित करूं?

X-Api-Key हेडर के माध्यम से अपना API key पास करें। अपनी dashboard में API Keys पेज से key जनरेट करें।

क्या API दर सीमाएं हैं?

नहीं। IPFS Ninja API अनुरोधों पर दर सीमाएं नहीं लगाता। आप किसी भी प्लान पर जितने चाहें उतने अनुरोध कर सकते हैं।

क्या API key समाप्त होती हैं?

नहीं। API key तब तक वैध हैं जब तक आप उन्हें हटा नहीं देते। आप कई key बना सकते हैं और उन्हें अलग-अलग रद्द कर सकते हैं।

API key और gateway टोकन में क्या अंतर है?

API key (bws_) के पास पूर्ण एक्सेस है — अपलोड, डिलीट, फ़ाइलें सूचीबद्ध करना। Gateway टोकन (gwt_) केवल-पढ़ने के लिए हैं और केवल आपके समर्पित gateway के माध्यम से फ़ाइलों तक पहुंच सकते हैं। Gateway टोकन फ्रंटएंड ऐप्स में एम्बेड करने के लिए सुरक्षित हैं।

समर्पित gateway

समर्पित gateway क्या है?

आपके अपने सबडोमेन (जैसे abc123.gw.ipfs.ninja) पर एक निजी IPFS gateway जो केवल आपके खाते में पिन की गई फ़ाइलों को सर्व करता है। सार्वजनिक gateway के विपरीत, यह अन्य उपयोगकर्ताओं के CID को resolve नहीं करेगा।

कौन से प्लान में समर्पित gateway शामिल है?

समर्पित gateway Nirvana प्लान ($29/माह) पर उपलब्ध हैं, जिसमें 50 GB/माह gateway बैंडविड्थ शामिल है।

क्या मैं अपने gateway तक पहुंच को प्रतिबंधित कर सकता हूं?

हां। आप token-required मोड (प्रत्येक अनुरोध पर gwt_ टोकन की आवश्यकता) सक्षम कर सकते हैं और/या IP whitelist सेट कर सकते हैं (100 पतों तक)।

क्या मैं अपने gateway को origin/डोमेन द्वारा प्रतिबंधित कर सकता हूं?

हां। HTTPS origin की सूची के साथ अपनी gateway सेटिंग्स में allowedOrigins कॉन्फ़िगर करें। केवल उन origin से ब्राउज़र अनुरोधों की अनुमति होगी। गैर-ब्राउज़र अनुरोध (Origin हेडर के बिना) बिना प्रतिबंध के गुजरते हैं। खाली सूची सभी origin की अनुमति देती है।

हस्ताक्षरित अपलोड टोकन क्या हैं?

हस्ताक्षरित अपलोड टोकन क्लाइंट-साइड अपलोड के लिए समय-सीमित क्रेडेंशियल हैं। आप उन्हें अपने सर्वर पर POST /upload/signed-url का उपयोग करके जनरेट करते हैं और ब्राउज़र या मोबाइल ऐप्स को पास करते हैं। क्लाइंट आपके API key को उजागर करने के बजाय Authorization: Signed <token> से प्रमाणित करता है। प्रत्येक टोकन उपयोग ट्रैक करता है और स्वचालित रूप से समाप्त होता है। विवरण के लिए हस्ताक्षरित टोकन दस्तावेज़ देखें।

क्या मैं IPFS से सर्व की गई इमेज को ऑप्टिमाइज़ कर सकता हूं?

हां। w, h, format और quality जैसे क्वेरी पैरामीटर के साथ GET /image/:cid का उपयोग करके इमेज का आकार बदलें, कन्वर्ट करें और कम्प्रेस करें। CID के आधार पर प्रतिक्रियाएं कैश की जाती हैं। यह सभी प्लान पर काम करता है। इमेज ऑप्टिमाइज़ेशन देखें।

क्या मैं फ़ाइलों में मेटाडेटा जोड़ सकता हूं?

हां। POST /upload/new से अपलोड करते समय या POST /pin से पिन करते समय 10 कुंजी-मान जोड़ियों तक के साथ metadata ऑब्जेक्ट शामिल करें। मेटाडेटा फ़ाइल सूचियों और फ़ाइल विवरण endpoint में लौटाया जाता है। फ़ाइलें और Pinning दस्तावेज़ देखें।

बिलिंग और प्लान

क्या कोई मुफ्त प्लान है?

हां। Dharma प्लान हमेशा के लिए मुफ्त है — 1 GB स्टोरेज, असीमित API अनुरोध, क्रेडिट कार्ड की आवश्यकता नहीं।

क्या बैंडविड्थ शुल्क हैं?

किसी भी प्लान पर API अनुरोधों पर कोई बैंडविड्थ शुल्क नहीं। समर्पित gateway बैंडविड्थ (Nirvana प्लान) में 50 GB/माह शामिल है। सीमा पूरी होने पर, gateway अनुरोध अगले महीने तक ब्लॉक किए जाते हैं।

क्या स्टोरेज रीसेट होता है?

स्टोरेज रीसेट नहीं होता। आपके प्लान में कुल स्टोरेज आवंटन (1 GB / 10 GB / 100 GB) शामिल है। जगह खाली करने के लिए, उन फ़ाइलों को हटाएं जिनकी आपको अब आवश्यकता नहीं है। अपने प्लान को अपग्रेड करने से आपका कुल आवंटन बढ़ता है।

क्या मैं कभी भी रद्द कर सकता हूं?

हां। बिलिंग पोर्टल के माध्यम से अपनी सदस्यता रद्द करें — कोई बाध्यता नहीं। आपका खाता मुफ्त स्तर पर वापस आ जाता है, और मौजूदा पिन की गई फ़ाइलें सुलभ रहती हैं।

यदि मैं डाउनग्रेड करता हूं तो मेरी फ़ाइलों का क्या होता है?

आपकी फ़ाइलें IPFS पर पिन रहती हैं, लेकिन यदि आपका वर्तमान उपयोग नए प्लान की स्टोरेज सीमा से अधिक है तो आप और अपलोड नहीं कर सकते। सीमा से नीचे वापस आने के लिए फ़ाइलें हटाएं।

सुरक्षा

क्या मेरा डेटा एन्क्रिप्टेड है?

सभी डेटा TLS/HTTPS के माध्यम से ट्रांजिट में एन्क्रिप्टेड है। प्रमाणीकरण JWT टोकन (Cognito) और सुरक्षित रूप से संग्रहीत API key का उपयोग करता है। IPFS पर फ़ाइल कंटेंट रेस्ट पर एन्क्रिप्टेड नहीं है — IPFS डिज़ाइन द्वारा एक सार्वजनिक नेटवर्क है।

क्या मेरे सर्वर-साइड कोड में API key का उपयोग करना सुरक्षित है?

हां। API key सर्वर-साइड उपयोग के लिए डिज़ाइन किए गए हैं। उन्हें कभी भी क्लाइंट-साइड कोड में उजागर न करें। क्लाइंट-साइड फ़ाइल एक्सेस के लिए, gateway टोकन (gwt_) का उपयोग करें जो केवल-पढ़ने के लिए हैं।

सहायता

मुझे मदद कैसे मिलेगी?

info@ipfs.ninja पर ईमेल करें या API संदर्भ दस्तावेज़ देखें।

क्या कोई SLA है?

हम उच्च उपलब्धता के लिए प्रयास करते हैं लेकिन वर्तमान में औपचारिक SLA प्रदान नहीं करते। सेवा "जैसी है" के आधार पर प्रदान की जाती है।