Фајлови

Отпремање, листа и преузимање фајлова на IPFS-у.

Отпремање фајла

POST /upload/new

Отпремите било који фајл на IPFS. Фајл се качи и враћа се трајни CID.

Тело захтева

Параметар	Тип	Обавезно	Опис
content	string | object	Да	JSON објекат/низ, или base64-кодирани подаци фајла (слике, PDF, HTML или било који тип фајла). За CAR увоз, base64-кодирана CAR датотека.
car	boolean	Не	Поставите на true за увоз CAR датотеке (DAG увоз). Чува тачне CID-ове.
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"
  })
});

Response 200 OK

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

CIDv1 подразумевано

Нова отпремања враћају модерни CIDv1 (bafk… за мали садржај у једном блоку, bafy… за веће фајлове и директоријуме) у складу са профилом IPIP-0499 unixfs-v1-2025 — делови од 1 MiB са сировим листовима (raw leaves). Стари Qm… CID-ови са ранијих отпремања остају потпуно разрешиви и настављају да раде на свакој крајњој тачки.

Алтернатива преко контролне табле

Страница /upload контролне табле прихвата превуци-и-пусти за фајлове, фолдере (упаковане у UnixFS директоријум у прегледачу) и .car архиве — све се усмерава кроз исту ову крајњу тачку. Погледајте CAR увоз за детаље о CAR путањи.

Преименовање фајла

PUT /files/:cid/name

Ажурирајте приказано име фајла. CID се не мења — то је хеш садржаја — мења се само ознака коју видите у листи фајлова.

Тело захтева

Параметар	Тип	Обавезно	Опис
name	string	Да	Ново приказано име. 1-200 карактера. Не сме садржати сепараторе путање (/, \). Имена која се састоје само од размака се одбијају.

Пример захтева

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

Response 200 OK

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

Контролна табла

Страница Фајлови има ставку Rename у менију радњи сваког реда фајла (дугме са три тачке). Исти ефекат, без потребе за кодом.

Листа фајлова

GET /upload/list

Преузмите листу ваших отпремљених IPFS фајлова у временском распону.

Параметри упита

Параметар	Тип	Обавезно	Опис
from	number	Да	Почетак временског распона, Unix временски печат у милисекундама.
to	number	Да	Крај временског распона, Unix временски печат у милисекундама.

Пример захтева

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

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

Преузимање фајла

GET /file/:cid

Преузмите метаподатке одређеног отпремљеног фајла по његовом CID.

Параметри путање

Параметар	Тип	Обавезно	Опис
cid	string	Да	IPFS идентификатор садржаја фајла.

Пример захтева

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

Response 200 OK

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