Брзи почетак

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

1. Набавите свој API кључ

Региструјте се на ipfs.ninja са својим Google налогом. Подразумевани API кључ се аутоматски креира. Идите на своју страницу Профил да прегледате и управљате својим API кључевима.

WARNING

Напомена: API кључеви немају рок трајања. Можете креирати више кључева и појединачно их опозвати са странице Профил.

2. Отпремите фајл

Пошаљите POST захтев на /upload/new са својим садржајем. Ево примера отпремања JSON објекта:

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 подразумевано

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

API враћа CID, величину фајла и URI-је за приступ:

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

3. Преузмите свој фајл

Приступите свом фајлу на два начина:

Преко IPFS gateway-а (без аутентификације)

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

TIP

Apex gateway https://ipfs.ninja/ipfs/<CID> сервира CID-ове које је отпремио или закачио било који корисник IPFS Ninja. CID-ови непознати платформи враћају HTTP 410 Gone — за њих користите јавни gateway (ipfs.io, dweb.link) или прво извршите POST /pin CID-а на свој налог.

Преко API-ја (враћа метаподатке фајла)

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

Одговор:

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

Алтернатива: Користите AWS SDK (S3-компатибилно)

Већ користите S3? Усмерите свој постојећи AWS SDK на https://s3.ipfs.ninja и користите свој API кључ као акредитиве:

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

Погледајте S3 компатибилност за пуну документацију са Python, Go и примерима миграције.

Више волите кликање? Користите контролну таблу

Ако не желите да пишете код, ipfs.ninja/upload прихвата превуци-и-пусти за:

• Било који фајл — превуците га на зону за отпремање, качи се + добијате CID
• Фолдер — упакован у UnixFS директоријум у вашем прегледачу, отпремљен као један увоз, разрешава се на /ipfs/{cid}/{subpath} за сваки дечији фајл
• .car архиву — аутоматски препозната, root CID сачуван тачно (погледајте CAR увоз)

Након отпремања, фајлови се појављују на страници Фајлови где можете да их преименујете, премештате између фолдера, добијете IPFS CID директоријума за цео фолдер (снимак), и конфигуришете S3 CORS по bucket-у за приступ browser SDK-а.

Следећи кораци

• Референца API-ја — Комплетна документација свих крајњих тачака, параметара и кодова грешака.
• S3 компатибилност — Користите AWS SDK за интеракцију са IPFS Ninja.
• Наменски gateway-и — Набавите приватни gateway који сервира само ваше фајлове.