Gyors kezdés

Töltse fel első fájlját az IPFS-re kevesebb mint két perc alatt.

1. Szerezze be API kulcsát

Regisztráljon az ipfs.ninja oldalon Google-fiókjával. Az alapértelmezett API kulcs automatikusan létrejön. Lépjen a Profil oldalra az API kulcsai megtekintéséhez és kezeléséhez.

WARNING

Megjegyzés: Az API kulcsok nem járnak le. Több kulcsot is létrehozhat, és egyenként visszavonhatja őket a Profil oldalról.

2. Töltsön fel egy fájlt

Küldjön egy POST kérést a /upload/new végpontra a tartalmával. Íme egy példa egy JSON objektum feltöltésére:

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 alapértelmezetten

Az új feltöltések modern CIDv1-et adnak (bafk… kis, egyblokkos tartalomhoz, bafy… nagyobb fájlokhoz és könyvtárakhoz) az IPIP-0499 szerint. A korábbi feltöltésekből származó örökölt Qm… CID-ek mindenhol továbbra is feloldhatók — mindkét formátum működik minden végpont bemeneteként.

Az API visszaadja a CID-et, a fájlméretet és a hozzáférési URI-kat:

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

3. Kérje le a fájlját

Kétféleképpen érheti el fájlját:

Az IPFS gateway-en keresztül (hitelesítés nélkül)

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

TIP

A https://ipfs.ninja/ipfs/<CID> apex átjáró bármely IPFS Ninja felhasználó által feltöltött vagy rögzített CID-eket szolgálja ki. A platform számára ismeretlen CID-ek HTTP 410 Gone választ adnak — ezekhez használjon nyilvános átjárót (ipfs.io, dweb.link), vagy előbb futtasson POST /pin-t a CID-re a fiókjában.

Az API-n keresztül (fájl metaadatokat ad vissza)

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

Válasz:

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

Alternatíva: az AWS SDK használata (S3-kompatibilis)

Már használ S3-at? Irányítsa a meglévő AWS SDK-ját a https://s3.ipfs.ninja címre, és használja API kulcsát hitelesítő adatként:

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

Teljes dokumentációért Python, Go és migrációs példákkal lásd az S3 kompatibilitást.

Inkább kattintana? Használja az irányítópultot

Ha nem szeretne kódot írni, az ipfs.ninja/upload elfogadja a húzd-és-ejtsd módszert:

• Bármilyen fájl — ejtse a feltöltési zónára, rögzítésre kerül, és megkapja a CID-et
• Egy mappa — a böngészőjében UnixFS könyvtárrá csomagolva, egyetlen importként feltöltve, minden gyermekfájlnál a /ipfs/{cid}/{subpath} címen oldódik fel
• Egy .car archívum — automatikusan felismerve, a gyökér CID pontosan megőrizve (lásd CAR import)

Feltöltés után a fájlok megjelennek a Fájlok oldalon, ahol átnevezheti, mappák között áthelyezheti őket, egy egész mappához IPFS könyvtár CID-et kérhet (pillanatkép), és bucketenként konfigurálhatja az S3 CORS-t a böngészős SDK hozzáféréshez.

Következő lépések

• API referencia — Teljes dokumentáció az összes végpontról, paraméterről és hibakódról.
• S3 kompatibilitás — Az AWS SDK használata az IPFS Ninja-val való interakcióhoz.
• Dedikált gateway-ek — Szerezzen privát gateway-t, amely csak az Ön fájljait szolgálja ki.