Skip to content

IPFS Ninja

Upload nemt billeder, PDF-filer og JSON-filer til IPFS og få en permanent indholdsidentifikator (CID) med øjeblikkelig gateway-adgang.

Hvad er IPFS?

InterPlanetary File System (IPFS) er en decentraliseret, peer-to-peer-lagringsprotokol. IPFS opdeler filer i mindre dele, distribuerer dem på tværs af netværket og tildeler hver fil en unik indholdsidentifikator (CID) baseret på dens indhold.

Det betyder:

  • Distribueret lagring — dine filer lagres på tværs af flere noder for forbedret pålidelighed.
  • Indholdsadressering — CID'en er afledt af selve filindholdet, hvilket sikrer uforanderlighed.
  • Netværksdækkende tilgængelighed — enhver med CID'en kan hente filen fra enhver IPFS-node.

Hvad IPFS Ninja gør

IPFS Ninja er en administreret tjeneste, der lader dig uploade filer og fastgøre eksisterende indhold på IPFS gennem et simpelt REST API. Ingen grund til at køre din egen IPFS-node.

  • Upload nye filer — send enhver fil via POST /upload/new og få et permanent CID
  • Fastgør eksisterende CID'er — har du allerede indhold på IPFS? Fastgør det til vores klynge via POST /pin for at sikre, at det forbliver tilgængeligt
  • Adgang via gateway — alt fastgjort indhold er tilgængeligt på ipfs.ninja/ipfs/<CID> (apex-gatewayen serverer kun CID'er fra din konto eller andre IPFS Ninja-konti — se Gateway-adgang nedenfor)
  • Brugerdefinerede metadata — vedhæft nøgle-værdi-par til uploads og fastgørelser til organisering og filtrering
  • Signerede upload-tokens — generer tidsbegrænsede tokens til klientside-uploads uden at eksponere din API-nøgle
  • IPNS foranderlige navne — opret stabile navne, der peger på skiftende CID'er via IPNS API, med op til 10 navne per konto
  • Billedoptimering — tilpas størrelse, konverter og komprimer billeder on-the-fly via gateway URL-parametre

Dashboard

Følg uploads, lagring og gateway-båndbredde fra dit personlige dashboard. Dashboardet lader dig også styre det meste af API'et uden at skrive kode:

  • Træk-og-slip-upload — filer, mapper (pakket til en UnixFS-mappe i din browser) eller .car-arkiver
  • Omdøb filer efter upload; beskrivelsen udfyldes automatisk fra filnavnet ved valg
  • Snapshot en mappe for at få et enkelt mappe-CID for alt indhold
  • Konfigurer S3 CORS per bucket via en formulareditor (til integrationer med browser-SDK)
  • Administrer API-nøgler, gateway-tokens, IPNS-navne og indstillinger for dedikeret gateway
IPFS Ninja Dashboard med analyser, diagrammer og brugsstatistik

Gateway-adgang

Hver uploadet fil er tilgængelig via IPFS Ninja gateway, som fungerer som en bro mellem det decentraliserede IPFS-netværk og traditionelle webbrowsere.

Gateway-URL'en følger dette mønster:

https://ipfs.ninja/ipfs/<CID>

Apex-gateway-omfang

Apex-gatewayen på https://ipfs.ninja/ipfs/<CID> serverer kun CID'er, der er blevet uploadet eller fastgjort af en registreret IPFS Ninja-bruger. Anmodninger om andre CID'er returnerer HTTP 410 Gone med en henvisning til offentlige IPFS-gateways som ipfs.io eller dweb.link. For at servere en tredjeparts-CID via vores gateway, tilmeld dig gratis og kør først POST /pin til din konto.

TIP

Dine filer er også tilgængelige fra enhver offentlig IPFS-gateway (f.eks. dweb.link, w3s.link) med det samme CID — IPFS-netværket er decentraliseret.

Alle betalte planer får en dedikeret gateway på deres eget underdomæne (<slug>.gw.ipfs.ninja), der kun serverer filer fastgjort til deres konto — med valgfri tokenbaseret adgangskontrol og oprindelsesbegrænsninger. Den dedikerede gateway er den anbefalede URL til produktionsindlejring (videoer, NFT-viewere, websteder).

Understøttede filtyper

TypeFormaterInput
JSONEthvert gyldigt JSON-objekt eller arraystring / object
BillederPNG, JPG, WebP, GIF, TIFF, SVGbase64
PDFStandard PDF-dokumenterbase64
HTMLHTML-dokumenterbase64
AlleEnhver fil (binær, tekst, video, osv.)base64

Alle filtyper accepteres. Typen registreres automatisk til din reference.

Sikkerhed

Gateway-svar inkluderer sikkerhedsheadere (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), der forhindrer browsere i at udføre scripts i serveret indhold.