সচরাচর জিজ্ঞাসিত প্রশ্নাবলী

IPFS Ninja সম্পর্কে সচরাচর জিজ্ঞাসিত প্রশ্নাবলী।

সাধারণ

IPFS Ninja কী?

IPFS Ninja একটি ম্যানেজড IPFS পিনিং সার্ভিস। আপনি একটি সহজ REST API-এর মাধ্যমে যেকোনো ফাইল আপলোড করতে পারেন, অথবা IPFS নেটওয়ার্ক থেকে বিদ্যমান CID পিন করতে পারেন। প্রতিটি ফাইল একটি স্থায়ী কন্টেন্ট আইডেন্টিফায়ার (CID) পায় এবং আমাদের gateway-তে ipfs.ninja/ipfs/<CID> এ অ্যাক্সেসযোগ্য।

ipfs.ninja/ipfs/<CID> কি IPFS নেটওয়ার্কের যেকোনো CID পরিবেশন করে?

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

apex গেটওয়ে এবং ডেডিকেটেড গেটওয়ের মধ্যে পার্থক্য কী?

দিক	apex ipfs.ninja/ipfs/<CID>	ডেডিকেটেড <slug>.gw.ipfs.ninja/ipfs/<CID>
পরিসর	সকল ব্যবহারকারীর মধ্যে শেয়ারড	শুধু আপনার CID
প্রমাণীকরণ	নেই	ঐচ্ছিক টোকেন / IP allowlist / origin allowlist
SLA	Best-effort	পূর্ণ SLA
জন্য প্রস্তাবিত	ক্যাজুয়াল লিঙ্ক	প্রোডাকশন এম্বেডিং (NFT, ভিডিও, ওয়েবসাইট)
রেট সীমা	প্রতি IP + প্রতি 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 দ্বারা পাবলিকভাবে অ্যাক্সেসযোগ্য। আপনার যদি প্রাইভেট অ্যাক্সেস প্রয়োজন হয়, টোকেন-প্রয়োজনীয় মোডে ডেডিকেটেড gateway ব্যবহার করুন — এটি আপনার gateway-এর মাধ্যমে অ্যাক্সেস সীমাবদ্ধ করে, যদিও কন্টেন্ট বৃহত্তর IPFS নেটওয়ার্কে উপলব্ধ থাকে।

আমার নতুন CID Qm... থেকে bafy...-তে কেন পরিবর্তিত হলো?

নতুন আপলোড এবং পিন IPIP-0499 unixfs-v1-2025 প্রোফাইল অনুযায়ী আধুনিক CIDv1 ফেরত দেয় (ছোট single-block কন্টেন্টের জন্য bafk…, বড় ফাইল ও ডিরেক্টরির জন্য bafy…): CIDv1 base32 এনকোডিং, 1 MiB চাংক, raw leaves। এটি আধুনিক টুলিং (Helia, সর্বশেষ Kubo, ipfs-car) একই কন্টেন্টের জন্য যা তৈরি করে তার সাথে মেলে, তাই আমাদের মাধ্যমে আপলোড করা একটি ফাইল যেকোনো আধুনিক ক্লায়েন্ট একই বাইটের জন্য যে CID গণনা করবে সেটিই পায়।

আগের আপলোডের লিগ্যাসি Qm… CID সম্পূর্ণভাবে resolve করার যোগ্য থাকে — gateway, POST /pin, GET /file, IPNS এবং অন্য প্রতিটি endpoint অনির্দিষ্টকালের জন্য উভয় ফরম্যাট গ্রহণ করে। আপনার কাছে ইতিমধ্যে যা আছে তা কাজ করা বন্ধ করে না।

একটি প্রাইভেট / নন-DHT নোডে বসবাসকারী কন্টেন্ট কীভাবে পিন করব?

POST /pin ঐচ্ছিক multiaddresses[] গ্রহণ করে (সর্বাধিক 5টি)। প্রদান করা হলে, পিন চালানোর আগে আমাদের ক্লাস্টার প্রতিটি হিন্টের জন্য ipfs swarm connect <multiaddr> করে, তাই যেসব peer পাবলিক DHT-এর মাধ্যমে বিজ্ঞাপন দিচ্ছে না (প্রাইভেট নোড, স্টেজিং এনভায়রনমেন্ট, VPN-লোকাল মেশিন) তাদের কন্টেন্ট পৌঁছানো যায়। একটি প্রাইভেট IPFS নোড থেকে পিন গাইড দেখুন।

আমি আমার অ্যাকাউন্ট বাতিল করলে কি আমার ফাইলগুলি IPFS-এ থাকবে?

আপনি বাতিল করলে আমরা আমাদের নোড থেকে আপনার ফাইলগুলি আনপিন করি। অন্যান্য IPFS নোড আপনার কন্টেন্ট ক্যাশ করে থাকলে, এটি এখনও অ্যাক্সেসযোগ্য থাকতে পারে। তবে, সক্রিয় পিনিং ছাড়া, নেটওয়ার্ক জুড়ে garbage collection দ্বারা ফাইলগুলি শেষ পর্যন্ত সরানো হবে।

প্রমাণীকরণ ও API

আমি কিভাবে API অনুরোধ প্রমাণীকরণ করব?

X-Api-Key হেডারের মাধ্যমে আপনার API key পাঠান। আপনার ড্যাশবোর্ডের API Keys পেজ থেকে কী তৈরি করুন।

API রেট লিমিট আছে কি?

না। IPFS Ninja API অনুরোধে রেট লিমিট আরোপ করে না। আপনি যেকোনো প্ল্যানে প্রয়োজন মতো অনুরোধ করতে পারেন।

API key-এর মেয়াদ শেষ হয় কি?

না। আপনি মুছে না দেওয়া পর্যন্ত API key বৈধ। আপনি একাধিক কী তৈরি করতে এবং আলাদাভাবে প্রত্যাহার করতে পারেন।

API key এবং gateway token-এর মধ্যে পার্থক্য কী?

API key (bws_) সম্পূর্ণ অ্যাক্সেস দেয় — আপলোড, ডিলিট, ফাইল তালিকা। Gateway token (gwt_) শুধুমাত্র পড়ার জন্য এবং শুধুমাত্র আপনার ডেডিকেটেড gateway-এর মাধ্যমে ফাইল অ্যাক্সেস করতে পারে। Gateway token ফ্রন্টএন্ড অ্যাপে এম্বেড করা নিরাপদ।

ডেডিকেটেড Gateway

ডেডিকেটেড gateway কী?

আপনার নিজস্ব সাবডোমেইনে (যেমন abc123.gw.ipfs.ninja) একটি প্রাইভেট IPFS gateway যা শুধুমাত্র আপনার অ্যাকাউন্টে পিন করা ফাইল সার্ভ করে। পাবলিক gateway-এর বিপরীতে, এটি অন্য ব্যবহারকারীদের CID সমাধান করবে না।

কোন প্ল্যানে ডেডিকেটেড gateway অন্তর্ভুক্ত?

ডেডিকেটেড gateway সব পেইড প্ল্যানে উপলব্ধ (Bodhi $5/মাস, Karma $19/মাস, Nirvana $59/মাস)। প্রতিটি প্ল্যানের মাসিক ব্যান্ডউইথ কোটা apex এবং ডেডিকেটেড উভয় gateway থেকে ট্র্যাফিক কভার করে। প্রতি-প্ল্যান কোটার জন্য নীচে "ব্যান্ডউইথ ফি আছে কি?" দেখুন।

আমার gateway কে অ্যাক্সেস করতে পারে তা সীমিত করতে পারি?

হ্যাঁ। আপনি টোকেন-প্রয়োজনীয় মোড সক্রিয় করতে পারেন (প্রতিটি অনুরোধে gwt_ টোকেন প্রয়োজন) এবং/অথবা IP whitelist সেট করতে পারেন (সর্বাধিক 100টি ঠিকানা)।

আমি কি origin/domain অনুসারে আমার gateway সীমিত করতে পারি?

হ্যাঁ। আপনার gateway সেটিংসে HTTPS origin-এর তালিকা সহ allowedOrigins কনফিগার করুন। শুধুমাত্র সেই origin থেকে ব্রাউজার অনুরোধ অনুমোদিত হবে। নন-ব্রাউজার অনুরোধ (Origin হেডার ছাড়া) বিধিনিষেধ ছাড়াই পাস করে। খালি তালিকা সব origin অনুমোদন করে।

সাইনড আপলোড টোকেন কী?

সাইনড আপলোড টোকেন হল ক্লায়েন্ট-সাইড আপলোডের জন্য সময়-সীমিত শংসাপত্র। আপনি POST /upload/signed-url ব্যবহার করে আপনার সার্ভারে এগুলি তৈরি করেন এবং ব্রাউজার বা মোবাইল অ্যাপে পাঠান। ক্লায়েন্ট আপনার API key প্রকাশ না করে Authorization: Signed <token> দিয়ে প্রমাণীকরণ করে। প্রতিটি টোকেন ব্যবহার ট্র্যাক করে এবং স্বয়ংক্রিয়ভাবে মেয়াদ শেষ হয়। বিস্তারিত জানতে সাইনড টোকেন ডকুমেন্টেশন দেখুন।

IPFS থেকে সার্ভ করা ইমেজ অপ্টিমাইজ করতে পারি?

হ্যাঁ। ইমেজ রিসাইজ, কনভার্ট এবং কম্প্রেস করতে w, h, format এবং quality-এর মতো query parameter সহ GET /image/:cid ব্যবহার করুন। রেসপন্স কন্টেন্ট-অ্যাড্রেসড CID-এর ভিত্তিতে ক্যাশ করা হয়। এটি সব প্ল্যানে কাজ করে। ইমেজ অপ্টিমাইজেশন দেখুন।

ফাইলে metadata সংযুক্ত করতে পারি?

হ্যাঁ। POST /upload/new-এর মাধ্যমে আপলোড বা POST /pin-এর মাধ্যমে পিন করার সময় সর্বাধিক 10টি কী-মানের জোড়া সহ একটি metadata অবজেক্ট অন্তর্ভুক্ত করুন। ফাইল তালিকা এবং ফাইল বিস্তারিত endpoint-এ metadata ফেরত দেওয়া হয়। ফাইলস এবং পিনিং ডকুমেন্টেশন দেখুন।

বিলিং ও প্ল্যান

বিনামূল্যের প্ল্যান আছে কি?

হ্যাঁ। Dharma প্ল্যান চিরকালের জন্য বিনামূল্যে — 1 GB স্টোরেজ, সীমাহীন API অনুরোধ, ক্রেডিট কার্ড প্রয়োজন নেই।

ব্যান্ডউইথ ফি আছে কি?

কোনো প্ল্যানে মিটার করা ব্যান্ডউইথ ফি নেই। প্রতিটি প্ল্যানে একটি মাসিক gateway ব্যান্ডউইথ কোটা অন্তর্ভুক্ত যা একটি কঠোর সীমা — কোটায় পৌঁছালে আপনার কন্টেন্ট apex এবং ডেডিকেটেড gateway উভয়েই সার্ভ করা বন্ধ হয়ে যায়, এবং পরবর্তী মাসের ১ তারিখে বা আপগ্রেডের পর পুনরায় শুরু হয়:

প্ল্যান	মাসিক ব্যান্ডউইথ
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

আপনি আপনার কোটার 80% এবং 100%-এ সতর্কতা ইমেইল পাবেন।

স্টোরেজ রিসেট হয় কি?

স্টোরেজ রিসেট হয় না। আপনার প্ল্যানে একটি মোট স্টোরেজ বরাদ্দ (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB) অন্তর্ভুক্ত। জায়গা খালি করতে, প্রয়োজন নেই এমন ফাইল মুছুন। আপনার প্ল্যান আপগ্রেড করলে মোট বরাদ্দ বাড়ে।

যেকোনো সময় বাতিল করতে পারি?

হ্যাঁ। বিলিং পোর্টালের মাধ্যমে আপনার সাবস্ক্রিপশন বাতিল করুন — কোনো লক-ইন নেই। আপনার অ্যাকাউন্ট বিনামূল্যের টিয়ারে ফিরে যায় এবং পিন করা ফাইলগুলি অ্যাক্সেসযোগ্য থাকে।

ডাউনগ্রেড করলে আমার ফাইলের কী হবে?

আপনার ফাইলগুলি IPFS-এ পিন করা থাকবে, তবে বর্তমান ব্যবহার নতুন প্ল্যানের স্টোরেজ সীমা ছাড়িয়ে গেলে আর আপলোড করতে পারবেন না। সীমার নিচে ফিরে আসতে ফাইল মুছুন।

নিরাপত্তা

আমার ডেটা কি এনক্রিপ্ট করা?

সমস্ত ডেটা TLS/HTTPS-এর মাধ্যমে ট্রানজিটে এনক্রিপ্ট করা। প্রমাণীকরণ JWT token (Cognito) এবং নিরাপদে সংরক্ষিত API key ব্যবহার করে। IPFS-এ ফাইলের কন্টেন্ট বিশ্রামে এনক্রিপ্ট করা নয় — IPFS ডিজাইন অনুসারে একটি পাবলিক নেটওয়ার্ক।

সার্ভার-সাইড কোডে API key ব্যবহার করা কি নিরাপদ?

হ্যাঁ। API key সার্ভার-সাইড ব্যবহারের জন্য ডিজাইন করা। ক্লায়েন্ট-সাইড কোডে কখনও প্রকাশ করবেন না। ক্লায়েন্ট-সাইড ফাইল অ্যাক্সেসের জন্য, gateway token (gwt_) ব্যবহার করুন যা শুধুমাত্র পড়ার জন্য।

সহায়তা

কিভাবে সাহায্য পাবো?

info@ipfs.ninja-তে ইমেইল করুন বা API রেফারেন্স ডকুমেন্টেশন দেখুন।

SLA আছে কি?

আমরা উচ্চ প্রাপ্যতার জন্য চেষ্টা করি তবে এই মুহূর্তে আনুষ্ঠানিক SLA অফার করি না। সেবাটি "যেমন আছে" ভিত্তিতে প্রদান করা হয়।