ডেডিকেটেড Gateway

Nirvana প্ল্যানের ব্যবহারকারীরা একটি অনন্য সাবডোমেইনে একটি প্রাইভেট IPFS gateway পান। এই gateway শুধুমাত্র আপনার অ্যাকাউন্টে পিন করা ফাইল সার্ভ করে — এটি অন্য ব্যবহারকারীদের বা পাবলিক IPFS নেটওয়ার্ক থেকে CID সমাধান করবে না।

আপনার gateway URL

আপনার gateway URL আপনার Gateway পেজে দেখানো হয় এবং /user/profile endpoint দ্বারা ফেরত দেওয়া হয়:

https://<your-slug>.gw.ipfs.ninja/ipfs/<CID>

অ্যাক্সেস মোড

মোড	আচরণ
খোলা (ডিফল্ট)	আপনার gateway URL + CID থাকা যে কেউ আপনার ফাইল অ্যাক্সেস করতে পারে। টোকেন প্রয়োজন নেই।
টোকেন প্রয়োজন	অনুরোধে ?token=gwt_... কোয়েরি প্যারাম বা X-Gateway-Token হেডারের মাধ্যমে gateway token অন্তর্ভুক্ত করতে হবে।

সীমা

• Nirvana-এ 50 GB/মাস gateway ব্যান্ডউইথ অন্তর্ভুক্ত
• ব্যান্ডউইথ সীমায় পৌঁছালে, gateway অনুরোধ পরবর্তী মাস পর্যন্ত 429 ফেরত দেয়
• প্রতি ক্যালেন্ডার মাসের প্রথম দিনে স্টোরেজ ব্যবহার রিসেট হয়
• শুধুমাত্র আপনার অ্যাকাউন্টে পিন করা CID সার্ভ করে — অন্য CID-এর অনুরোধ 403 ফেরত দেয়

apex গেটওয়ে

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

এমন CID-এর জন্য যা আপনার নয়, আপনি হয় (a) POST /pin করে এটি আপনার অ্যাকাউন্টে পিন করতে পারেন এবং তারপর apex URL ব্যবহার করতে পারেন, অথবা (b) https://ipfs.io/ipfs/<CID> বা https://dweb.link/ipfs/<CID>-এর মতো তৃতীয় পক্ষের গেটওয়ে ব্যবহার করতে পারেন।

প্রোডাকশন-গ্রেড এম্বেডিংয়ের জন্য (ভিডিও, NFT ভিউয়ার, সাইট), উপরের ডেডিকেটেড গেটওয়েটি প্রস্তাবিত প্যাটার্ন — এটি উচ্চতর রেট সীমা, কনফিগারযোগ্য অ্যাক্সেস নিয়ন্ত্রণ এবং ডেডিকেটেড ব্যান্ডউইথ প্রদান করে।

Gateway সেটিংস

আপনার ডেডিকেটেড gateway-এর জন্য অ্যাক্সেস নিয়ন্ত্রণ কনফিগার করুন।

সেটিংস আপডেট

PUT /gateway-settings

প্যারামিটার	ধরন	প্রয়োজনীয়	বর্ণনা
tokenRequired	boolean	না	Gateway token প্রয়োজনীয়তা সক্রিয়/নিষ্ক্রিয় করুন।
ipWhitelist	string[]	না	অনুমোদিত IP ঠিকানার অ্যারে। সর্বাধিক 100। খালি অ্যারে whitelist সরিয়ে দেয়।
allowedOrigins	string[]	না	ব্রাউজার অনুরোধের জন্য অনুমোদিত origin-এর অ্যারে। সর্বাধিক 100। HTTPS ফরম্যাট হতে হবে (যেমন https://myapp.com)। খালি অ্যারে সব origin অনুমোদন করে।

উদাহরণ

# টোকেন-প্রয়োজনীয় মোড সক্রিয় করুন
curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"tokenRequired": true}'

# IP whitelist সেট করুন
curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ipWhitelist": ["203.0.113.1", "198.51.100.0"]}'

# IP whitelist মুছুন (সব IP অনুমোদন করুন)
curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ipWhitelist": []}'

# নির্দিষ্ট origin-এ সীমাবদ্ধ করুন
curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"allowedOrigins": ["https://myapp.com", "https://staging.myapp.com"]}'

# Origin বিধিনিষেধ সরান (সব origin অনুমোদন করুন)
curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"allowedOrigins": []}'

Origin বিধিনিষেধ

allowedOrigins কনফিগার করা হলে, শুধুমাত্র তালিকাভুক্ত origin থেকে ব্রাউজার অনুরোধ অনুমোদিত। Gateway আসা অনুরোধগুলিতে Origin এবং Referer হেডার পরীক্ষা করে।

• তালিকা খালি হলে (ডিফল্ট), সব origin অনুমোদিত।
• Origin নির্দিষ্ট করা হলে, কোনো এন্ট্রির সাথে না মিলে এমন Origin বা Referer হেডার সহ অনুরোধ 403 রেসপন্স দিয়ে প্রত্যাখ্যান করা হয়।
• Origin হেডার অন্তর্ভুক্ত না করা নন-ব্রাউজার অনুরোধ (যেমন সার্ভার-সাইড fetch বা curl) বিধিনিষেধ ছাড়াই পাস করে।

আপনার ওয়েব অ্যাপ্লিকেশনে gateway কন্টেন্ট এম্বেড করার জন্য এটি উপযোগী এবং অন্য সাইটগুলিকে আপনার ফাইল সরাসরি লিংক করা থেকে বিরত রাখে।

Gateway Tokens

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

সক্ষমতা	API Key (bws_)	Gateway Token (gwt_)
ফাইল আপলোড / ডিলিট	হ্যাঁ	না
ফাইল metadata তালিকা / পান	হ্যাঁ	না
Gateway-এর মাধ্যমে ফাইল পড়ুন	না	হ্যাঁ
Frontend-এ এম্বেড করা নিরাপদ	না	হ্যাঁ

Gateway Token তৈরি করুন

POST /gateway-tokens

প্যারামিটার	ধরন	প্রয়োজনীয়	বর্ণনা
name	string	না	টোকেনের জন্য লেবেল (যেমন "Frontend")। ডিফল্ট "Default"।

প্রতিক্রিয়া 201 Created

{
  "token": "gwt_a1b2c3d4e5f6789012345678abcdef01",
  "tokenPrefix": "gwt_a1b2c3d4",
  "tokenName": "Frontend",
  "createdAt": 1711036800000
}

WARNING

সম্পূর্ণ টোকেন শুধুমাত্র তৈরির সময় একবার ফেরত দেওয়া হয়। নিরাপদে সংরক্ষণ করুন।

Gateway Tokens তালিকা

GET /gateway-tokens

[
  {
    "tokenPrefix": "gwt_a1b2c3d4",
    "tokenName": "Frontend",
    "createdAt": 1711036800000
  }
]

Gateway Token মুছুন

DELETE /gateway-tokens/:prefix

প্যারামিটার	ধরন	প্রয়োজনীয়	বর্ণনা
prefix	string	হ্যাঁ	মুছতে টোকেন prefix (যেমন "gwt_a1b2c3d4")।

Gateway token ব্যবহার

আপনার gateway-এ টোকেন-প্রয়োজনীয় মোড সক্রিয় থাকলে, কোয়েরি প্যারামিটার বা হেডার হিসাবে টোকেন পাঠান:

# কোয়েরি প্যারামিটার
curl "https://a1b2c3d4.gw.ipfs.ninja/ipfs/QmXk7VRz...?token=gwt_your_token"

# অথবা হেডার
curl https://a1b2c3d4.gw.ipfs.ninja/ipfs/QmXk7VRz... \
  -H "X-Gateway-Token: gwt_your_token"