Tiedostot

Lataa, listaa ja hae tiedostoja IPFS:ssä.

Lataa tiedosto

POST /upload/new

Lataa mikä tahansa tiedosto IPFS:ään. Tiedosto kiinnitetään ja pysyvä CID palautetaan.

Pyynnön runko

Parametri	Tyyppi	Pakollinen	Kuvaus
content	string | object	Kyllä	JSON-objekti/taulukko tai base64-koodattu tiedostodata (kuvat, PDF, HTML tai mikä tahansa tiedostotyyppi). CAR-tuonneille base64-koodattu CAR-tiedosto.
car	boolean	Ei	Aseta arvoon true tuodaksesi CAR-tiedoston (DAG-tuonti). Säilyttää tarkat CID-tunnisteet.
description	string	Ei	Lyhyt kuvaus ladatusta sisällöstä.
metadata	object	Ei	Mukautetut avain-arvo-parit liitettäväksi tiedostoon. Enintään 10 avainta. Avainten on oltava aakkosnumeerisia tai alaviivoja, 1-64 merkkiä. Arvojen on oltava merkkijonoja, enintään 256 merkkiä kukin. Metatietojen kokonaiskoko ei saa ylittää 4 KB.

Esimerkkipyyntö

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

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

Vastaus 200 OK

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

CIDv1 oletuksena

Uudet lataukset palauttavat nykyaikaisen CIDv1-tunnisteen (bafk… pienelle yksilohkoiselle sisällölle, bafy… suuremmille tiedostoille ja hakemistoille) IPIP-0499 unixfs-v1-2025 -profiilin mukaisesti — 1 MiB:n lohkot raakalehdillä. Aiempien latausten vanhat Qm…-CID:t pysyvät täysin ratkaistavissa ja toimivat edelleen jokaisen päätepisteen kanssa.

Hallintapaneelin vaihtoehto

Hallintapaneelin /upload-sivu hyväksyy vedä ja pudota -toiminnon tiedostoille, kansioille (pakattu UnixFS-hakemistoksi selaimessa) ja .car-arkistoille — kaikki reitittyvät saman päätepisteen kautta. Katso CAR-tuonti lisätietoja CAR-polusta.

Nimeä tiedosto uudelleen

PUT /files/:cid/name

Päivitä tiedoston näyttönimi. CID ei muutu — se on sisällön tiiviste — vain tiedostolistassasi näkyvä nimike muuttuu.

Pyynnön runko

Parametri	Tyyppi	Pakollinen	Kuvaus
name	string	Kyllä	Uusi näyttönimi. 1-200 merkkiä. Ei saa sisältää polkuerottimia (/, \). Pelkästä välilyönnistä koostuvat nimet hylätään.

Esimerkkipyyntö

curl -X PUT https://api.ipfs.ninja/files/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi/name \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Season 1 promo art" }'

Vastaus 200 OK

{
  "success": true,
  "cid": "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
  "name": "Season 1 promo art"
}

Hallintapaneeli

Tiedostot-sivulla on Nimeä uudelleen -toiminto jokaisen tiedostorivin toimintovalikossa (kolmen pisteen painike). Sama vaikutus, ei koodia tarvita.

Listaa tiedostot

GET /upload/list

Hae lista ladatuista IPFS-tiedostoista aikavälin sisällä.

Kyselyparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
from	number	Kyllä	Aikavälin alku, Unix-aikaleima millisekunneissa.
to	number	Kyllä	Aikavälin loppu, Unix-aikaleima millisekunneissa.

Esimerkkipyyntö

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

Vastaus 200 OK

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

Hae tiedosto

GET /file/:cid

Hae tietyn ladatun tiedoston metatiedot sen CID:n perusteella.

Polkuparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
cid	string	Kyllä	Tiedoston IPFS-sisältötunniste.

Esimerkkipyyntö

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

Vastaus 200 OK

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