Ghid rapid

Încărcați primul fișier pe IPFS în mai puțin de două minute.

1. Obțineți cheia API

Înregistrați-vă pe ipfs.ninja cu contul dvs. Google. O cheie API implicită este creată automat. Accesați pagina Profil pentru a vizualiza și gestiona cheile API.

WARNING

Notă: Cheile API nu expiră. Puteți crea mai multe chei și le puteți revoca individual din pagina Profil.

2. Încărcați un fișier

Trimiteți o cerere POST către /upload/new cu conținutul dvs. Iată un exemplu de încărcare a unui obiect 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 implicit

Încărcările noi produc CIDv1 modern (bafk… pentru conținut mic, cu un singur bloc, bafy… pentru fișiere și directoare mai mari) conform IPIP-0499. CID-urile vechi Qm… din încărcările anterioare se rezolvă în continuare peste tot — ambele formate funcționează ca intrări pentru fiecare endpoint.

API-ul returnează CID-ul, dimensiunea fișierului și URI-urile de acces:

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

3. Accesați fișierul

Accesați fișierul în două moduri:

Prin gateway-ul IPFS (fără autentificare necesară)

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

TIP

Gateway-ul apex https://ipfs.ninja/ipfs/<CID> servește CID-uri încărcate sau fixate de orice utilizator IPFS Ninja. CID-urile necunoscute platformei returnează HTTP 410 Gone — pentru acestea, folosiți un gateway public (ipfs.io, dweb.link) sau executați mai întâi POST /pin pe CID în contul dvs.

Prin API (returnează metadatele fișierului)

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

Răspuns:

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

Alternativă: folosiți SDK-ul AWS (compatibil S3)

Folosiți deja S3? Îndreptați SDK-ul AWS existent către https://s3.ipfs.ninja și folosiți cheia dvs. API drept credențiale:

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

Consultați Compatibilitate S3 pentru documentația completă cu exemple Python, Go și de migrare.

Preferați să faceți clic? Folosiți Dashboard-ul

Dacă preferați să nu scrieți cod, ipfs.ninja/upload acceptă tragere și plasare pentru:

• Orice fișier — plasați-l pe zona de încărcare, este fixat și primiți CID-ul
• Un folder — împachetat într-un director UnixFS în browserul dvs., încărcat ca un singur import, se rezolvă la /ipfs/{cid}/{subpath} pentru fiecare fișier copil
• O arhivă .car — detectată automat, CID-ul rădăcină păstrat exact (vezi Import CAR)

Odată încărcate, fișierele apar pe pagina Fișiere unde puteți redenumi, muta între foldere, obține un CID de director IPFS pentru un întreg folder (snapshot) și configura S3 CORS per bucket pentru accesul din SDK-ul de browser.

Pași următori

• Referința API — Documentație completă pentru toate endpoint-urile, parametrii și codurile de eroare.
• Compatibilitate S3 — Folosiți SDK-ul AWS pentru a interacționa cu IPFS Ninja.
• Gateway-uri dedicate — Obțineți un gateway privat care servește doar fișierele dvs.