দ্রুত শুরু

দুই মিনিটেরও কম সময়ে আপনার প্রথম ফাইল IPFS-এ আপলোড করুন।

1. আপনার API key পান

আপনার Google অ্যাকাউন্ট দিয়ে ipfs.ninja-তে সাইন আপ করুন। একটি ডিফল্ট API key স্বয়ংক্রিয়ভাবে তৈরি হয়। আপনার API key দেখতে এবং পরিচালনা করতে আপনার প্রোফাইল পেজে যান।

WARNING

দ্রষ্টব্য: API key-এর মেয়াদ শেষ হয় না। আপনি একাধিক কী তৈরি করতে পারেন এবং আপনার প্রোফাইল পেজ থেকে আলাদাভাবে প্রত্যাহার করতে পারেন।

2. একটি ফাইল আপলোড করুন

আপনার কন্টেন্ট সহ /upload/new-তে একটি POST অনুরোধ পাঠান। এখানে একটি JSON অবজেক্ট আপলোড করার উদাহরণ:

curl

curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "name": "My NFT",
      "description": "A permanent file on IPFS",
      "image": "ipfs://bafybeiExampleCID..."
    },
    "description": "NFT metadata"
  }'

JavaScript

const response = await fetch("https://api.ipfs.ninja/upload/new", {
  method: "POST",
  headers: {
    "X-Api-Key": "bws_your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    content: {
      name: "My NFT",
      description: "A permanent file on IPFS",
      image: "ipfs://bafybeiExampleCID..."
    },
    description: "NFT metadata"
  })
});

const data = await response.json();
console.log(data.cid);       // "bafybeigdyrzt5..."
console.log(data.uris.url);  // "https://ipfs.ninja/ipfs/bafybeigdyrzt5..."

ডিফল্টরূপে CIDv1

নতুন আপলোড আধুনিক CIDv1 তৈরি করে (ছোট single-block কন্টেন্টের জন্য bafk…, বড় ফাইল ও ডিরেক্টরির জন্য bafy…) IPIP-0499 অনুযায়ী। আগের আপলোডের লিগ্যাসি Qm… CID এখনও সর্বত্র resolve হয় — উভয় ফরম্যাটই প্রতিটি endpoint-এ ইনপুট হিসেবে কাজ করে।

API CID, ফাইলের আকার এবং অ্যাক্সেস URI ফেরত দেয়:

{
  "cid": "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
  "sizeMB": 0.001,
  "uris": {
    "ipfs": "ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
    "url": "https://ipfs.ninja/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi"
  }
}

3. আপনার ফাইল পুনরুদ্ধার করুন

দুটি উপায়ে আপনার ফাইল অ্যাক্সেস করুন:

IPFS gateway-এর মাধ্যমে (auth প্রয়োজন নেই)

curl https://ipfs.ninja/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

TIP

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

API-এর মাধ্যমে (ফাইল metadata ফেরত দেয়)

curl https://api.ipfs.ninja/file/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi \
  -H "X-Api-Key: bws_your_api_key_here"

প্রতিক্রিয়া:

{
  "cid": "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
  "fileName": "NFT metadata",
  "fileType": "json",
  "sizeMB": 0.001,
  "createdAt": 1711036800000,
  "uris": {
    "ipfs": "ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
    "url": "https://ipfs.ninja/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi"
  }
}

বিকল্প: AWS SDK ব্যবহার করুন (S3-সামঞ্জস্যপূর্ণ)

ইতিমধ্যে S3 ব্যবহার করছেন? আপনার বিদ্যমান AWS SDK-কে https://s3.ipfs.ninja-এ পয়েন্ট করুন এবং আপনার API key কে ক্রেডেনশিয়াল হিসেবে ব্যবহার করুন:

import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";

const s3 = new S3Client({
  endpoint: "https://s3.ipfs.ninja",
  credentials: { accessKeyId: "bws_prefix", secretAccessKey: "bws_fullkey" },
  region: "us-east-1",
  forcePathStyle: true
});

await s3.send(new PutObjectCommand({
  Bucket: "my-project",
  Key: "my-file.json",
  Body: JSON.stringify({ hello: "IPFS" })
}));

Python, Go এবং মাইগ্রেশন উদাহরণসহ সম্পূর্ণ ডকুমেন্টেশনের জন্য S3 সামঞ্জস্যতা দেখুন।

ক্লিক করতে পছন্দ করেন? ড্যাশবোর্ড ব্যবহার করুন

আপনি যদি কোড লিখতে না চান, ipfs.ninja/upload নিম্নলিখিতগুলির জন্য drag-and-drop গ্রহণ করে:

• যেকোনো ফাইল — আপলোড জোনে এটি ড্রপ করুন, পিন করা হয় + আপনি CID পান
• একটি ফোল্ডার — আপনার ব্রাউজারে একটি UnixFS ডিরেক্টরিতে প্যাক করা হয়, একক ইমপোর্ট হিসেবে আপলোড করা হয়, প্রতিটি চাইল্ড ফাইলের জন্য /ipfs/{cid}/{subpath}-এ resolve হয়
• একটি .car আর্কাইভ — স্বয়ংক্রিয়ভাবে শনাক্ত, রুট CID হুবহু সংরক্ষিত (দেখুন CAR Import)

আপলোড হয়ে গেলে, ফাইলগুলি Files পেজে দেখা যায় যেখানে আপনি পুনঃনামকরণ, ফোল্ডারের মধ্যে সরানো, একটি সম্পূর্ণ ফোল্ডারের জন্য একটি IPFS ডিরেক্টরি CID পাওয়া (স্ন্যাপশট), এবং ব্রাউজার SDK অ্যাক্সেসের জন্য প্রতি-বাকেট S3 CORS কনফিগার করতে পারেন।

পরবর্তী পদক্ষেপ

• API রেফারেন্স — সমস্ত endpoint, প্যারামিটার এবং এরর কোডের সম্পূর্ণ ডকুমেন্টেশন।
• S3 সামঞ্জস্যতা — IPFS Ninja-এর সাথে ইন্টারঅ্যাক্ট করতে AWS SDK ব্যবহার করুন।
• ডেডিকেটেড Gateway — একটি প্রাইভেট gateway পান যা শুধুমাত্র আপনার ফাইল সার্ভ করে।