IPFS Ninja

সহজেই ইমেজ, PDF এবং JSON ফাইল IPFS-এ আপলোড করুন এবং তাৎক্ষণিক gateway অ্যাক্সেস সহ একটি স্থায়ী কন্টেন্ট আইডেন্টিফায়ার (CID) পান।

IPFS কী?

InterPlanetary File System (IPFS) হল একটি বিকেন্দ্রীভূত, peer-to-peer স্টোরেজ প্রোটোকল। IPFS ফাইলগুলিকে ছোট ছোট অংশে ভাগ করে, নেটওয়ার্ক জুড়ে বিতরণ করে এবং প্রতিটি ফাইলকে তার বিষয়বস্তুর উপর ভিত্তি করে একটি অনন্য কন্টেন্ট আইডেন্টিফায়ার (CID) নির্ধারণ করে।

এর অর্থ:

• বিতরিত স্টোরেজ — আপনার ফাইলগুলি উন্নত নির্ভরযোগ্যতার জন্য একাধিক নোড জুড়ে সংরক্ষিত হয়।
• কন্টেন্ট অ্যাড্রেসিং — CID ফাইলের বিষয়বস্তু থেকে তৈরি, অপরিবর্তনীয়তা নিশ্চিত করে।
• নেটওয়ার্ক-ব্যাপী অ্যাক্সেসযোগ্যতা — CID থাকা যে কেউ যেকোনো IPFS নোড থেকে ফাইলটি পুনরুদ্ধার করতে পারে।

IPFS Ninja কী করে

IPFS Ninja একটি ম্যানেজড সার্ভিস যা আপনাকে একটি সহজ REST API-এর মাধ্যমে ফাইল আপলোড করতে এবং IPFS-এ বিদ্যমান কন্টেন্ট পিন করতে দেয়। আপনার নিজের IPFS নোড চালানোর প্রয়োজন নেই।

• নতুন ফাইল আপলোড করুন — POST /upload/new-এর মাধ্যমে যেকোনো ফাইল পাঠান এবং একটি স্থায়ী CID পান
• বিদ্যমান CID পিন করুন — IPFS-এ ইতিমধ্যে কন্টেন্ট আছে? POST /pin-এর মাধ্যমে আমাদের ক্লাস্টারে পিন করুন যাতে এটি উপলব্ধ থাকে
• gateway-এর মাধ্যমে অ্যাক্সেস — সমস্ত পিন করা কন্টেন্ট ipfs.ninja/ipfs/<CID>-এ অ্যাক্সেসযোগ্য (apex গেটওয়ে শুধুমাত্র আপনার অ্যাকাউন্টে বা অন্যান্য IPFS Ninja অ্যাকাউন্টে থাকা CID পরিবেশন করে — নীচে গেটওয়ে অ্যাক্সেস দেখুন)
• কাস্টম metadata — সংগঠন এবং ফিল্টারিংয়ের জন্য আপলোড এবং পিনে কী-মানের জোড়া সংযুক্ত করুন
• সাইনড আপলোড টোকেন — আপনার API key প্রকাশ না করেই ক্লায়েন্ট-সাইড আপলোডের জন্য সময়-সীমিত টোকেন তৈরি করুন
• IPNS পরিবর্তনযোগ্য নাম — IPNS API-এর মাধ্যমে পরিবর্তনশীল CID-এ নির্দেশ করা স্থিতিশীল নাম তৈরি করুন, প্রতি অ্যাকাউন্টে সর্বাধিক ১০টি নাম
• ইমেজ অপ্টিমাইজেশন — gateway URL প্যারামিটারের মাধ্যমে on-the-fly-তে ইমেজ রিসাইজ, কনভার্ট এবং কম্প্রেস করুন

ড্যাশবোর্ড

আপনার ব্যক্তিগত ড্যাশবোর্ড থেকে আপলোড, স্টোরেজ এবং gateway ব্যান্ডউইথ ট্র্যাক করুন। ড্যাশবোর্ড আপনাকে কোনো কোড না লিখেই API-এর বেশিরভাগ অংশ চালাতেও দেয়:

• Drag-and-drop আপলোড — ফাইল, ফোল্ডার (আপনার ব্রাউজারে একটি UnixFS ডিরেক্টরিতে প্যাক করা), অথবা .car আর্কাইভ
• আপলোডের পর ফাইলের নাম পরিবর্তন করুন; নির্বাচনে ফাইলনাম থেকে বর্ণনা স্বয়ংক্রিয়ভাবে পূরণ হয়
• ভেতরের সবকিছুর জন্য একটি একক ডিরেক্টরি CID পেতে একটি ফোল্ডার স্ন্যাপশট করুন
• একটি ফর্ম এডিটরের মাধ্যমে প্রতি-bucket S3 CORS কনফিগার করুন (ব্রাউজার SDK ইন্টিগ্রেশনের জন্য)
• API key, gateway token, IPNS নাম এবং ডেডিকেটেড gateway সেটিংস পরিচালনা করুন

Gateway অ্যাক্সেস

প্রতিটি আপলোড করা ফাইল IPFS Ninja gateway-এর মাধ্যমে অ্যাক্সেসযোগ্য, যা বিকেন্দ্রীভূত IPFS নেটওয়ার্ক এবং ঐতিহ্যবাহী ওয়েব ব্রাউজারগুলির মধ্যে সেতু হিসাবে কাজ করে।

gateway URL নিম্নলিখিত প্যাটার্ন অনুসরণ করে:

https://ipfs.ninja/ipfs/<CID>

apex গেটওয়ের পরিসর

https://ipfs.ninja/ipfs/<CID>-এর apex গেটওয়ে শুধুমাত্র সেই CID গুলি পরিবেশন করে যেগুলি একজন নিবন্ধিত IPFS Ninja ব্যবহারকারী দ্বারা আপলোড বা পিন করা হয়েছে। অন্য কোনো CID-এর জন্য অনুরোধগুলি HTTP 410 Gone ফেরত দেয় এবং ipfs.io বা dweb.link-এর মতো পাবলিক IPFS গেটওয়েগুলির দিকে নির্দেশ করে। আমাদের গেটওয়ের মাধ্যমে তৃতীয় পক্ষের CID পরিবেশন করতে, বিনামূল্যে সাইন আপ করুন এবং প্রথমে আপনার অ্যাকাউন্টে POST /pin করুন।

TIP

আপনার ফাইলগুলি একই CID ব্যবহার করে যেকোনো পাবলিক IPFS gateway (যেমন dweb.link, w3s.link) থেকেও অ্যাক্সেসযোগ্য — IPFS নেটওয়ার্ক বিকেন্দ্রীভূত।

সমস্ত পেইড প্ল্যান তাদের নিজস্ব সাবডোমেইনে (<slug>.gw.ipfs.ninja) একটি ডেডিকেটেড gateway পায় যা শুধুমাত্র তাদের অ্যাকাউন্টে পিন করা ফাইল সার্ভ করে — ঐচ্ছিক টোকেন-ভিত্তিক অ্যাক্সেস নিয়ন্ত্রণ এবং অরিজিন বিধিনিষেধ সহ। প্রোডাকশন এম্বেডিংয়ের (ভিডিও, NFT ভিউয়ার, ওয়েবসাইট) জন্য ডেডিকেটেড gateway সুপারিশকৃত URL।

সমর্থিত ফাইলের ধরন

ধরন	ফরম্যাট	ইনপুট
JSON	যেকোনো বৈধ JSON অবজেক্ট বা অ্যারে	string / object
ইমেজ	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	স্ট্যান্ডার্ড PDF ডকুমেন্ট	base64
HTML	HTML ডকুমেন্ট	base64
যেকোনো	যেকোনো ফাইল (binary, text, video ইত্যাদি)	base64

সব ধরনের ফাইল গ্রহণ করা হয়। ধরনটি স্বয়ংক্রিয়ভাবে শনাক্ত এবং রেকর্ড করা হয় আপনার রেফারেন্সের জন্য।

নিরাপত্তা

gateway রেসপন্সে নিরাপত্তা হেডার (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) অন্তর্ভুক্ত থাকে যা ব্রাউজারগুলিকে পরিবেশিত কন্টেন্টে স্ক্রিপ্ট চালানো থেকে বিরত রাখে।