Vanlige spørsmål

Ofte stilte spørsmål om IPFS Ninja.

Generelt

Hva er IPFS Ninja?

IPFS Ninja er en administrert IPFS-festingstjeneste. Du laster opp hvilken som helst fil via et enkelt REST API, eller fester eksisterende CID-er fra IPFS-nettverket. Hver fil får en permanent innholdsidentifikator (CID) og er tilgjengelig via vår gateway på ipfs.ninja/ipfs/<CID>.

Serverer ipfs.ninja/ipfs/<CID> enhver CID på IPFS-nettverket?

Nei. Apex-gatewayen serverer kun CID-er som er lastet opp eller festet av en IPFS Ninja-bruker. Forespørsler om ukjente CID-er returnerer HTTP 410 Gone med en henvisning til offentlige IPFS-gateways (ipfs.io, dweb.link). For å servere en tredjeparts-CID via vår gateway, kjør først POST /pin til kontoen din — når den er festet, er CID-en tilgjengelig både på apex- og din dedikerte gateway-URL.

Hva er forskjellen mellom apex-gatewayen og den dedikerte gatewayen?

Aspekt	Apex ipfs.ninja/ipfs/<CID>	Dedikert <slug>.gw.ipfs.ninja/ipfs/<CID>
Omfang	Delt mellom alle brukere	Bare dine CID-er
Autentisering	Ingen	Valgfri token / IP-allowlist / origin-allowlist
SLA	Beste innsats	Full SLA
Anbefalt for	Tilfeldige lenker	Produksjonsinnbygging (NFT, video, nettsteder)
Hastighetsgrenser	Delt per IP + per CID	Per plan, konfigurerbar

Begge serverer identisk innhold. For produksjonstrafikk, bruk den dedikerte gatewayen.

Hvilke filtyper støttes?

Alle filtyper støttes. JSON-objekter og arrayer kan sendes direkte. Alle andre filer (bilder, PDF, HTML, video, lyd, binærfiler) sendes som base64-kodet innhold.

Finnes det en filstørrelsesgrense?

Individuelle opplastinger er begrenset av planens lagringskvote. Det finnes ingen grense per fil utover din tilgjengelige lagring.

Kan jeg feste innhold som allerede finnes på IPFS?

Ja. Bruk POST /pin med hvilken som helst gyldig CID. Klyngen vår henter innholdet fra IPFS-nettverket og fester det til kontoen din. Se Pinning API-dokumentasjonen for detaljer.

Hvor lang tid tar festing?

Det avhenger av filstørrelse og hvor mange IPFS-noder som har innholdet. Små, godt distribuerte filer festes på sekunder. Stort eller sjelden festet innhold kan ta noen minutter. Festingsendepunktet returnerer umiddelbart med status pinning — poll GET /pin/:cid for å sjekke fremdriften.

Hva skjer hvis en CID ikke kan finnes?

Statusen endres til failed. Det betyr at CID-en enten er ugyldig eller at innholdet ikke lenger er tilgjengelig på noen tilgjengelig IPFS-node.

Er data som lastes opp til IPFS offentlig?

Ja. Alt innhold festet til IPFS er offentlig tilgjengelig via sin CID gjennom hvilken som helst IPFS-gateway. Hvis du trenger privat tilgang, bruk en dedikert gateway med tokenkravsmodus — dette begrenser tilgangen gjennom din gateway, selv om innholdet forblir tilgjengelig på det bredere IPFS-nettverket.

Hvorfor endret mine nye CID-er seg fra Qm... til bafy...?

Nye opplastinger og festinger returnerer moderne CIDv1 (bafk… for lite innhold i én blokk, bafy… for større filer og kataloger) i tråd med IPIP-0499 unixfs-v1-2025-profilen: CIDv1 base32-koding, 1 MiB-biter, rå blader. Dette samsvarer med det moderne verktøy (Helia, nyeste Kubo, ipfs-car) produserer for det samme innholdet, så en fil lastet opp gjennom oss får samme CID som enhver moderne klient ville beregnet for de samme bytene.

Eldre Qm…-CID-er fra tidligere opplastinger forblir fullt oppløselige — gatewayen, POST /pin, GET /file, IPNS og alle andre endepunkter godtar begge formatene på ubestemt tid. Ingenting du allerede har slutter å fungere.

Hvordan fester jeg innhold som ligger på en privat/ikke-DHT-node?

POST /pin godtar valgfrie multiaddresses[] (opptil 5). Hvis dette oppgis, kjører klyngen vår ipfs swarm connect <multiaddr> for hvert hint før festingen kjører, slik at innhold på noder som ikke annonserer via den offentlige DHT-en (private noder, staging-miljøer, VPN-lokale maskiner) blir tilgjengelig. Se guiden Fest fra en privat IPFS-node.

Forblir filene mine på IPFS hvis jeg kansellerer kontoen min?

Vi frigir festingen av filene dine fra våre noder når du kansellerer. Hvis andre IPFS-noder har cachet innholdet ditt, kan det forbli tilgjengelig. Men uten aktiv festing vil filer etter hvert bli fjernet av søppelinnsamling over nettverket.

Autentisering & API

Hvordan autentiserer jeg API-forespørsler?

Send API-nøkkelen din via X-Api-Key-headeren. Generer nøkler fra siden API-nøkler i dashbordet ditt.

Finnes det API-hastighetsbegrensninger?

Nei. IPFS Ninja pålegger ikke hastighetsbegrensninger på API-forespørsler. Du kan gjøre så mange forespørsler du trenger på hvilken som helst plan.

Utløper API-nøkler?

Nei. API-nøkler er gyldige til du sletter dem. Du kan opprette flere nøkler og tilbakekalle dem individuelt.

Hva er forskjellen mellom API-nøkler og gateway-tokener?

API-nøkler (bws_) har full tilgang — laste opp, slette, liste filer. Gateway-tokener (gwt_) er skrivebeskyttet og kan bare få tilgang til filer via din dedikerte gateway. Gateway-tokener er trygge å bygge inn i frontend-apper.

Dedikerte gateways

Hva er en dedikert gateway?

En privat IPFS-gateway på ditt eget underdomene (f.eks. abc123.gw.ipfs.ninja) som bare serverer filer festet til kontoen din. I motsetning til den offentlige gatewayen vil den ikke løse opp CID-er fra andre brukere.

Hvilke planer inkluderer en dedikert gateway?

Dedikerte gateways er tilgjengelige på alle betalte planer (Bodhi $5/mnd, Karma $19/mnd, Nirvana $59/mnd). Hver plans månedlige båndbreddekvote dekker trafikk fra både apex- og den dedikerte gatewayen. Se «Er det båndbreddekostnader?» nedenfor for kvoter per plan.

Kan jeg begrense hvem som har tilgang til min gateway?

Ja. Du kan aktivere tokenkravsmodus (krever et gwt_-token ved hver forespørsel) og/eller sette opp en IP-hviteliste (opptil 100 adresser).

Kan jeg begrense min gateway etter opprinnelse/domene?

Ja. Konfigurer allowedOrigins i dine gateway-innstillinger med en liste over HTTPS-opprinnelser. Bare nettleserforespørsler fra disse opprinnelsene tillates. Forespørsler uten nettleser (uten Origin-header) slipper gjennom. En tom liste tillater alle opprinnelser.

Hva er signerte opplastingstokener?

Signerte opplastingstokener er tidsbegrensede legitimasjonsopplysninger for opplastinger på klientsiden. Du genererer dem på serveren din med POST /upload/signed-url og sender dem til nettlesere eller mobilapper. Klienten autentiserer med Authorization: Signed <token> i stedet for å eksponere API-nøkkelen din. Hvert token sporer bruk og utløper automatisk. Se dokumentasjonen for signerte tokener for detaljer.

Kan jeg optimalisere bilder servert fra IPFS?

Ja. Bruk GET /image/:cid med spørringsparametere som w, h, format og quality for å endre størrelse, konvertere og komprimere bilder direkte. Svar caches basert på den innholdsadresserte CID-en. Dette fungerer på alle planer. Se Bildeoptimalisering.

Kan jeg legge ved metadata til filer?

Ja. Inkluder et metadata-objekt med opptil 10 nøkkel-verdi-par når du laster opp via POST /upload/new eller fester via POST /pin. Metadata returneres i fillister og fildetalj-endepunktet. Se dokumentasjonen for Filer og Festing.

Fakturering & Planer

Finnes det en gratis plan?

Ja. Dharma-planen er gratis for alltid — 1 GB lagring, ubegrensede API-forespørsler, ingen kredittkort påkrevd.

Er det båndbreddekostnader?

Ingen målte båndbreddekostnader på noen plan. Hver plan inkluderer en månedlig gateway-båndbreddekvote som er en hard grense — innholdet ditt slutter å bli servert på apex- og den dedikerte gatewayen når kvoten er nådd, og gjenopptas den 1. i neste måned eller etter en oppgradering:

Plan	Månedlig båndbredde
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Du vil motta varsel-e-poster ved 80 % og 100 % av kvoten din.

Tilbakestilles lagring?

Lagring tilbakestilles ikke. Planen din inkluderer en total lagringskvote (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). For å frigjøre plass, slett filer du ikke lenger trenger. Oppgradering av planen øker den totale kvoten din.

Kan jeg kansellere når som helst?

Ja. Kanseller abonnementet ditt via faktureringsportalen — ingen binding. Kontoen din går tilbake til det gratis nivået, og eksisterende festede filer forblir tilgjengelige.

Hva skjer med filene mine hvis jeg nedgraderer?

Filene dine forblir festet til IPFS, men du kan ikke laste opp mer hvis din nåværende bruk overstiger den nye planens lagringsgrense. Slett filer for å komme under grensen.

Sikkerhet

Er dataene mine kryptert?

Alle data er kryptert under overføring via TLS/HTTPS. Autentisering bruker JWT-tokener (Cognito) og API-nøkler lagret sikkert. Filinnhold på IPFS er ikke kryptert i hvile — IPFS er et offentlig nettverk av design.

Er det trygt å bruke API-nøkler i serverkoden min?

Ja. API-nøkler er designet for bruk på serversiden. Eksponer dem aldri i klientkode. For filtilgang på klientsiden, bruk gateway-tokener (gwt_) som er skrivebeskyttede.

Support

Hvordan får jeg hjelp?

Send e-post til info@ipfs.ninja eller sjekk API-referansen.

Finnes det et SLA?

Vi streber etter høy tilgjengelighet, men tilbyr for øyeblikket ikke et formelt SLA. Tjenesten tilbys på en "som den er"-basis.