फ़ाइलें

IPFS पर फ़ाइलें अपलोड करें, सूचीबद्ध करें और पुनः प्राप्त करें।

फ़ाइल अपलोड करें

POST /upload/new

IPFS पर कोई भी फ़ाइल अपलोड करें। फ़ाइल पिन की जाती है और एक स्थायी CID लौटाया जाता है।

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
content	string | object	हां	JSON ऑब्जेक्ट/एरे, या base64-एन्कोडेड फ़ाइल डेटा (इमेज, PDF, HTML या कोई भी फ़ाइल प्रकार)।
description	string	नहीं	अपलोड की गई सामग्री का संक्षिप्त विवरण।
metadata	object	नहीं	फ़ाइल से जोड़ने के लिए कस्टम कुंजी-मान जोड़ियां। अधिकतम 10 कुंजियां। कुंजियां अल्फ़ान्यूमेरिक या अंडरस्कोर होनी चाहिए, 1-64 अक्षर। मान स्ट्रिंग होने चाहिए, प्रत्येक अधिकतम 256 अक्षर। कुल मेटाडेटा आकार 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 timestamp।
to	number	हां	समय सीमा का अंत, मिलीसेकंड में Unix timestamp।

उदाहरण अनुरोध

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 द्वारा किसी विशिष्ट अपलोड की गई फ़ाइल के मेटाडेटा प्राप्त करें।

पथ पैरामीटर

पैरामीटर	प्रकार	आवश्यक	विवरण
cid	string	हां	फ़ाइल का IPFS content identifier।

उदाहरण अनुरोध

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"
  }
}