Skip to content

IPFS Ninja

Last enkelt opp bilder, PDF-filer og JSON-filer til IPFS og få en permanent innholdsidentifikator (CID) med umiddelbar gateway-tilgang.

Hva er IPFS?

InterPlanetary File System (IPFS) er en desentralisert, peer-to-peer-lagringsprotokoll. IPFS deler filer opp i mindre deler, distribuerer dem over nettverket og tildeler hver fil en unik innholdsidentifikator (CID) basert på innholdet.

Det betyr:

  • Distribuert lagring — filene dine lagres på tvers av flere noder for forbedret pålitelighet.
  • Innholdsadressering — CID-en er utledet fra selve filinnholdet, noe som sikrer uforanderlighet.
  • Nettverksomfattende tilgjengelighet — alle med CID-en kan hente filen fra hvilken som helst IPFS-node.

Hva IPFS Ninja gjør

IPFS Ninja er en administrert tjeneste som lar deg laste opp filer og feste eksisterende innhold på IPFS gjennom et enkelt REST API. Ingen grunn til å kjøre din egen IPFS-node.

  • Last opp nye filer — send hvilken som helst fil via POST /upload/new og få et permanent CID
  • Fest eksisterende CID-er — har du allerede innhold på IPFS? Fest det til klyngen vår via POST /pin for å sikre at det forblir tilgjengelig
  • Tilgang via gateway — alt festet innhold er tilgjengelig på ipfs.ninja/ipfs/<CID> (apex-gatewayen serverer kun CID-er fra kontoen din eller fra andre IPFS Ninja-kontoer — se Gateway-tilgang nedenfor)
  • Egendefinerte metadata — legg ved nøkkel-verdi-par til opplastinger og festinger for organisering og filtrering
  • Signerte opplastingstokener — generer tidsbegrensede tokener for klientsidige opplastinger uten å eksponere API-nøkkelen din
  • IPNS foranderlige navn — opprett stabile navn som peker på skiftende CID-er via IPNS API, med opptil 10 navn per konto
  • Bildeoptimalisering — endre størrelse, konverter og komprimer bilder direkte via gateway URL-parametere

Dashbord

Følg opplastinger, lagring og gateway-båndbredde fra ditt personlige dashbord. Dashbordet lar deg også styre det meste av API-et uten å skrive kode:

  • Dra-og-slipp-opplasting — filer, mapper (pakket inn i en UnixFS-katalog i nettleseren din) eller .car-arkiver
  • Gi nytt navn til filer etter opplasting; beskrivelsen fylles automatisk ut fra filnavnet når du velger
  • Ta et øyeblikksbilde av en mappe for å få én katalog-CID for alt innholdet
  • Konfigurer S3 CORS per bucket via en skjemabasert editor (for integrasjoner med nettleser-SDK-er)
  • Administrer API-nøkler, gateway-tokener, IPNS-navn og innstillinger for dedikert gateway
IPFS Ninja Dashbord med analyser, diagrammer og bruksstatistikk

Gateway-tilgang

Hver opplastet fil er tilgjengelig via IPFS Ninja gateway, som fungerer som en bro mellom det desentraliserte IPFS-nettverket og tradisjonelle nettlesere.

Gateway-URL-en følger dette mønsteret:

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

Apex-gatewayens omfang

Apex-gatewayen på https://ipfs.ninja/ipfs/<CID> serverer kun CID-er som er lastet opp eller festet av en registrert IPFS Ninja-bruker. Forespørsler om andre CID-er returnerer HTTP 410 Gone med en henvisning til offentlige IPFS-gateways som ipfs.io eller dweb.link. For å servere en tredjeparts-CID via vår gateway, registrer deg gratis og kjør først POST /pin til kontoen din.

TIP

Filene dine er også tilgjengelige fra hvilken som helst offentlig IPFS-gateway (f.eks. dweb.link, w3s.link) med samme CID — IPFS-nettverket er desentralisert.

Alle betalte planer får en dedikert gateway på sitt eget underdomene (<slug>.gw.ipfs.ninja) som bare serverer filer festet til kontoen deres — med valgfri tokenbasert tilgangskontroll og opprinnelsesbegrensninger. Den dedikerte gatewayen er den anbefalte URL-en for produksjonsinnbygging (videoer, NFT-visninger, nettsteder).

Støttede filtyper

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

Alle filtyper aksepteres. Typen identifiseres automatisk og registreres for din referanse.

Sikkerhet

Gateway-svar inkluderer sikkerhetshoder (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) som forhindrer nettlesere fra å kjøre skript i servert innhold.