ডেডিকেটেড Gateway

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

Gateways list page with multiple gateway cards

আপনার 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 ফেরত দেয়

TIP

ipfs.ninja/ipfs/-এ পাবলিক gateway সমস্ত প্ল্যানে উপলব্ধ এবং প্রমাণীকরণ ছাড়াই যেকোনো CID সার্ভ করে।

Gateway সেটিংস

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

Gateway detail page with access mode, token required, and IP whitelist settings

সেটিংস আপডেট

PUT /gateway-settings

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

উদাহরণ

bash

# টোকেন-প্রয়োজনীয় মোড সক্রিয় করুন
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`

json

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

WARNING

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

Gateway Tokens তালিকা

GET /gateway-tokens

json

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

Gateway Token মুছুন

DELETE /gateway-tokens/:prefix

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

Gateway token ব্যবহার

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

bash

# কোয়েরি প্যারামিটার
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"

ডেডিকেটেড Gateway ​

আপনার gateway URL ​

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

সীমা ​

Gateway সেটিংস ​

সেটিংস আপডেট ​

উদাহরণ ​

Origin বিধিনিষেধ ​

Gateway Tokens ​

Gateway Token তৈরি করুন ​

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

Gateway Tokens তালিকা ​

Gateway Token মুছুন ​

Gateway token ব্যবহার ​