দ্রুত শুরু

দুই মিনিটেরও কম সময়ে আপনার প্রথম ফাইল 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://QmExampleCID..."
    },
    "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://QmExampleCID..."
    },
    description: "NFT metadata"
  })
});

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

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

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

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

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

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

curl https://ipfs.ninja/ipfs/QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN

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

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

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

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

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

• API রেফারেন্স — সমস্ত endpoint, প্যারামিটার এবং এরর কোডের সম্পূর্ণ ডকুমেন্টেশন।
• ডেডিকেটেড Gateway — একটি প্রাইভেট gateway পান যা শুধুমাত্র আপনার ফাইল সার্ভ করে। Nirvana প্ল্যানে উপলব্ধ।