ফাইলস

IPFS-এ ফাইল আপলোড, তালিকা এবং পুনরুদ্ধার করুন।

ফাইল আপলোড

POST /upload/new

IPFS-এ যেকোনো ফাইল আপলোড করুন। ফাইলটি পিন করা হয় এবং একটি স্থায়ী CID ফেরত দেওয়া হয়।

অনুরোধের বডি

প্যারামিটার	ধরন	প্রয়োজনীয়	বর্ণনা
content	string | object	হ্যাঁ	JSON অবজেক্ট/অ্যারে, বা base64-এনকোডেড ফাইল ডেটা (ইমেজ, PDF, HTML, বা যেকোনো ফাইলের ধরন)।
description	string	না	আপলোড করা কন্টেন্টের সংক্ষিপ্ত বর্ণনা।
metadata	object	না	ফাইলে সংযুক্ত করার জন্য কাস্টম কী-মানের জোড়া। সর্বাধিক 10টি কী। কী অবশ্যই অক্ষরসংখ্যা বা আন্ডারস্কোর হতে হবে, 1-64 অক্ষর। মান অবশ্যই স্ট্রিং হতে হবে, প্রতিটি সর্বাধিক 256 অক্ষর। মোট metadata আকার 4 KB-এর বেশি হওয়া যাবে না।

উদাহরণ অনুরোধ

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": "example", "value": 42 },
    "description": "Test upload",
    "metadata": {
      "project": "my-app",
      "environment": "production"
    }
  }'

ইমেজ আপলোড (base64)

const fs = require("fs");
const image = fs.readFileSync("photo.png").toString("base64");

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: image,
    description: "Profile photo"
  })
});

প্রতিক্রিয়া 200 OK

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

ফাইল তালিকা

GET /upload/list

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

কোয়েরি প্যারামিটার

প্যারামিটার	ধরন	প্রয়োজনীয়	বর্ণনা
from	number	হ্যাঁ	সময়সীমার শুরু, Unix টাইমস্ট্যাম্প milliseconds-এ।
to	number	হ্যাঁ	সময়সীমার শেষ, Unix টাইমস্ট্যাম্প milliseconds-এ।

উদাহরণ অনুরোধ

curl "https://api.ipfs.ninja/upload/list?from=1704067200000&to=1735689600000" \
  -H "X-Api-Key: bws_your_api_key_here"

প্রতিক্রিয়া 200 OK

[
  {
    "cid": "QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN",
    "fileName": "Test upload",
    "fileType": "json",
    "sizeMB": 0.001,
    "createdAt": 1711036800000,
    "metadata": {
      "project": "my-app",
      "environment": "production"
    },
    "uris": {
      "ipfs": "ipfs://QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN",
      "url": "https://ipfs.ninja/ipfs/QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN"
    }
  }
]

ফাইল পান

GET /file/:cid

CID দ্বারা একটি নির্দিষ্ট আপলোড করা ফাইলের metadata পুনরুদ্ধার করুন।

Path প্যারামিটার

প্যারামিটার	ধরন	প্রয়োজনীয়	বর্ণনা
cid	string	হ্যাঁ	ফাইলের IPFS কন্টেন্ট আইডেন্টিফায়ার।

উদাহরণ অনুরোধ

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

প্রতিক্রিয়া 200 OK

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