Hurtigstart

Last opp din første fil til IPFS på under to minutter.

1. Hent API-nøkkelen din

Registrer deg på ipfs.ninja med Google-kontoen din. En standard API-nøkkel opprettes automatisk. Gå til Profilsiden din for å se og administrere API-nøklene dine.

WARNING

Merk: API-nøkler utløper ikke. Du kan opprette flere nøkler og tilbakekalle dem individuelt fra Profilsiden din.

2. Last opp en fil

Send en POST-forespørsel til /upload/new med innholdet ditt. Her er et eksempel på opplasting av et JSON-objekt:

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 som standard

Nye opplastinger produserer moderne CIDv1 (bafk… for lite innhold i én blokk, bafy… for større filer og kataloger) i tråd med IPIP-0499. Eldre Qm…-CID-er fra tidligere opplastinger løses fortsatt opp overalt — begge formatene fungerer som inndata til alle endepunkter.

API-et returnerer CID, filstørrelse og tilgangs-URI-er:

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

3. Hent filen din

Få tilgang til filen din på to måter:

Via IPFS-gateway (ingen autentisering nødvendig)

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

TIP

Apex-gatewayen https://ipfs.ninja/ipfs/<CID> serverer CID-er lastet opp eller festet av enhver IPFS Ninja-bruker. CID-er som er ukjente for plattformen returnerer HTTP 410 Gone — for disse, bruk en offentlig gateway (ipfs.io, dweb.link) eller kjør først POST /pin på CID-en til kontoen din.

Via API-et (returnerer filmetadata)

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

Svar:

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

Alternativ: Bruk AWS SDK (S3-kompatibel)

Bruker du allerede S3? Pek din eksisterende AWS SDK mot https://s3.ipfs.ninja og bruk API-nøkkelen din som legitimasjon:

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

Se S3-kompatibilitet for full dokumentasjon med Python-, Go- og migreringseksempler.

Foretrekker du å klikke? Bruk Dashbordet

Hvis du heller ikke vil skrive kode, godtar ipfs.ninja/upload dra-og-slipp for:

• Enhver fil — slipp den på opplastingssonen, den blir festet + du får CID-en
• En mappe — pakket inn i en UnixFS-katalog i nettleseren din, lastet opp som én import, løses opp på /ipfs/{cid}/{subpath} for hver underliggende fil
• Et .car-arkiv — oppdages automatisk, rot-CID-en bevares nøyaktig (se CAR Import)

Når opplastet, vises filene på Filer-siden hvor du kan gi nytt navn, flytte mellom mapper, få en IPFS-katalog-CID for en hel mappe (øyeblikksbilde), og konfigurere S3 CORS per bucket for tilgang via nettleser-SDK.

Neste steg

• API-referanse — Full dokumentasjon for alle endepunkter, parametere og feilkoder.
• S3-kompatibilitet — Bruk AWS SDK til å samhandle med IPFS Ninja.
• Dedikerte gateways — Få en privat gateway som bare serverer filene dine.