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

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

সাধারণ

IPFS Ninja কী?

IPFS Ninja একটি ম্যানেজড IPFS পিনিং সার্ভিস। আপনি একটি সহজ REST API-এর মাধ্যমে যেকোনো ফাইল আপলোড করতে পারেন, অথবা IPFS নেটওয়ার্ক থেকে বিদ্যমান CID পিন করতে পারেন। প্রতিটি ফাইল একটি স্থায়ী কন্টেন্ট আইডেন্টিফায়ার (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 দ্বারা পাবলিকভাবে অ্যাক্সেসযোগ্য। আপনার যদি প্রাইভেট অ্যাক্সেস প্রয়োজন হয়, টোকেন-প্রয়োজনীয় মোডে ডেডিকেটেড gateway ব্যবহার করুন — এটি আপনার gateway-এর মাধ্যমে অ্যাক্সেস সীমাবদ্ধ করে, যদিও কন্টেন্ট বৃহত্তর 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 Nirvana প্ল্যানে ($29/মাস) উপলব্ধ, যার মধ্যে 50 GB/মাস 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 অনুরোধ, ক্রেডিট কার্ড প্রয়োজন নেই।

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

যেকোনো প্ল্যানে API অনুরোধের জন্য কোনো ব্যান্ডউইথ ফি নেই। ডেডিকেটেড gateway ব্যান্ডউইথ (Nirvana প্ল্যান) 50 GB/মাস অন্তর্ভুক্ত। সীমায় পৌঁছালে, পরবর্তী মাস পর্যন্ত gateway অনুরোধ ব্লক করা হয়।

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

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

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

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

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

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

নিরাপত্তা

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

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

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

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

সহায়তা

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

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

SLA আছে কি?

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