FAQ

Ofte stillede spørgsmål om IPFS Ninja.

Generelt

Hvad er IPFS Ninja?

IPFS Ninja er en administreret IPFS-fastgørelsestjeneste. Du uploader enhver fil via et simpelt REST API, eller fastgør eksisterende CID'er fra IPFS-netværket. Hver fil får en permanent indholdsidentifikator (CID) og er tilgængelig via vores gateway på ipfs.ninja/ipfs/<CID>.

Serverer ipfs.ninja/ipfs/<CID> enhver CID på IPFS-netværket?

Nej. Apex-gatewayen serverer kun CID'er, der er blevet uploadet eller fastgjort af en IPFS Ninja-bruger. Anmodninger om ukendte CID'er returnerer HTTP 410 Gone med en henvisning til offentlige IPFS-gateways (ipfs.io, dweb.link). For at servere en tredjeparts-CID via vores gateway, kør først POST /pin til din konto — når den er fastgjort, er CID'en tilgængelig på både apex- og din dedikerede gateway-URL.

Hvad er forskellen mellem apex-gatewayen og den dedikerede gateway?

Aspekt	Apex ipfs.ninja/ipfs/<CID>	Dedikeret <slug>.gw.ipfs.ninja/ipfs/<CID>
Omfang	Delt mellem alle brugere	Kun dine CID'er
Godkendelse	Ingen	Valgfri token / IP-allowlist / origin-allowlist
SLA	Bedste indsats	Fuld SLA
Anbefalet til	Tilfældige links	Produktionsindlejring (NFT, video, websteder)
Rategrænser	Delt pr. IP + pr. CID	Pr. plan, konfigurerbar

Begge serverer identisk indhold. Brug den dedikerede gateway til produktionstrafik.

Hvilke filtyper understøttes?

Alle filtyper understøttes. JSON-objekter og arrays kan sendes direkte. Alle andre filer (billeder, PDF, HTML, video, lyd, binære filer) sendes som base64-kodet indhold.

Er der en filstørrelsesgrænse?

Individuelle uploads er begrænset af din plans lagringskvotering. Der er ingen grænse per fil ud over din tilgængelige lagring.

Kan jeg fastgøre indhold, der allerede findes på IPFS?

Ja. Brug POST /pin med ethvert gyldigt CID. Vores klynge henter indholdet fra IPFS-netværket og fastgør det til din konto. Se Pinning API-dokumentationen for detaljer.

Hvor lang tid tager fastgørelse?

Det afhænger af filstørrelse, og hvor mange IPFS-noder der har indholdet. Små, veldistribuerede filer fastgøres på sekunder. Stort eller sjældent fastgjort indhold kan tage et par minutter. Fastgørelses-endpointet returnerer øjeblikkeligt med status pinning — poll GET /pin/:cid for at tjekke fremskridtet.

Hvad sker der, hvis et CID ikke kan findes?

Statussen ændres til failed. Det betyder, at CID'et enten er ugyldigt, eller at indholdet ikke længere er tilgængeligt på nogen tilgængelig IPFS-node.

Er data uploadet til IPFS offentlig?

Ja. Alt indhold fastgjort til IPFS er offentligt tilgængeligt via dets CID gennem enhver IPFS-gateway. Hvis du har brug for privat adgang, brug en dedikeret gateway med token-påkrævet tilstand — dette begrænser adgangen gennem din gateway, selvom indholdet forbliver tilgængeligt på det bredere IPFS-netværk.

Hvorfor ændrede mine nye CID'er sig fra Qm... til bafy...?

Nye uploads og fastgørelser returnerer moderne CIDv1 (bafk… til lille indhold i én blok, bafy… til større filer og mapper) efter IPIP-0499 unixfs-v1-2025-profilen: CIDv1 base32-kodning, 1 MiB-chunks, raw leaves. Dette matcher, hvad moderne værktøjer (Helia, seneste Kubo, ipfs-car) producerer for det samme indhold, så en fil uploadet via os får det samme CID, som ethvert moderne værktøj ville beregne for de samme bytes.

Ældre Qm…-CID'er fra tidligere uploads forbliver fuldt opløselige — gatewayen, POST /pin, GET /file, IPNS og ethvert andet endpoint accepterer begge formater på ubestemt tid. Intet, du allerede har, holder op med at virke.

Hvordan fastgør jeg indhold, der findes på en privat/ikke-DHT-node?

POST /pin accepterer valgfrie multiaddresses[] (op til 5). Hvis angivet, udfører vores klynge ipfs swarm connect <multiaddr> for hvert hint før fastgørelsen køres, så indhold på peers, der ikke annoncerer via den offentlige DHT (private noder, staging-miljøer, VPN-lokale maskiner), kan nås. Se guiden Fastgør fra en privat IPFS-node.

Forbliver mine filer på IPFS, hvis jeg annullerer min konto?

Vi fjerner fastgørelsen af dine filer fra vores noder, når du annullerer. Hvis andre IPFS-noder har cachet dit indhold, kan det forblive tilgængeligt. Men uden aktiv fastgørelse vil filer til sidst blive fjernet af affaldsindsamling på tværs af netværket.

Autentificering & API

Hvordan autentificerer jeg API-forespørgsler?

Send din API-nøgle via X-Api-Key-headeren. Generer nøgler fra siden API-nøgler i dit dashboard.

Er der API-hastighedsgrænser?

Nej. IPFS Ninja pålægger ikke hastighedsgrænser på API-forespørgsler. Du kan lave så mange forespørgsler, du har brug for, på enhver plan.

Udløber API-nøgler?

Nej. API-nøgler er gyldige, indtil du sletter dem. Du kan oprette flere nøgler og tilbagekalde dem individuelt.

Hvad er forskellen mellem API-nøgler og gateway-tokens?

API-nøgler (bws_) har fuld adgang — upload, slet, list filer. Gateway-tokens (gwt_) er skrivebeskyttede og kan kun tilgå filer via din dedikerede gateway. Gateway-tokens er sikre at indlejre i frontend-apps.

Dedikerede gateways

Hvad er en dedikeret gateway?

En privat IPFS-gateway på dit eget underdomæne (f.eks. abc123.gw.ipfs.ninja), der kun serverer filer fastgjort til din konto. I modsætning til den offentlige gateway vil den ikke opløse CID'er fra andre brugere.

Hvilke planer inkluderer en dedikeret gateway?

Dedikerede gateways er tilgængelige på alle betalte planer (Bodhi $5/md, Karma $19/md, Nirvana $59/md). Hver plans månedlige båndbreddekvote dækker trafik fra både apex- og dedikerede gateways. Se "Er der båndbreddegebyrer?" nedenfor for kvoter per plan.

Kan jeg begrænse, hvem der har adgang til min gateway?

Ja. Du kan aktivere token-påkrævet tilstand (kræver et gwt_-token ved hver forespørgsel) og/eller indstille en IP-hvidliste (op til 100 adresser).

Kan jeg begrænse min gateway efter oprindelse/domæne?

Ja. Konfigurer allowedOrigins i dine gateway-indstillinger med en liste over HTTPS-oprindelser. Kun browserforespørgsler fra disse oprindelser tillades. Ikke-browserforespørgsler (uden en Origin-header) passerer igennem. En tom liste tillader alle oprindelser.

Hvad er signerede upload-tokens?

Signerede upload-tokens er tidsbegrænsede legitimationsoplysninger til klientside-uploads. Du genererer dem på din server med POST /upload/signed-url og sender dem til browsere eller mobilapps. Klienten autentificerer med Authorization: Signed <token> i stedet for at eksponere din API-nøgle. Hvert token sporer brug og udløber automatisk. Se dokumentationen for signerede tokens for detaljer.

Kan jeg optimere billeder serveret fra IPFS?

Ja. Brug GET /image/:cid med forespørgselsparametre som w, h, format og quality til at tilpasse størrelse, konvertere og komprimere billeder on-the-fly. Svar caches baseret på det indholdsadresserede CID. Dette virker på alle planer. Se Billedoptimering.

Kan jeg vedhæfte metadata til filer?

Ja. Inkluder et metadata-objekt med op til 10 nøgle-værdi-par, når du uploader via POST /upload/new eller fastgør via POST /pin. Metadata returneres i fillister og fildetalje-endpointet. Se dokumentationen for Filer og Fastgørelse.

Fakturering & Planer

Er der en gratis plan?

Ja. Dharma-planen er gratis for evigt — 1 GB lagring, ubegrænsede API-forespørgsler, intet kreditkort påkrævet.

Er der båndbreddegebyrer?

Ingen målte båndbreddegebyrer på nogen plan. Hver plan inkluderer en månedlig gateway-båndbreddekvote, der er et hårdt loft — dit indhold holder op med at blive serveret på apex- og dedikerede gateways, når kvoten er nået, og genoptages den 1. i næste måned eller efter en opgradering:

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

Du modtager advarselsmails ved 80% og 100% af din kvote.

Nulstilles lagring?

Lagring nulstilles ikke. Din plan inkluderer en total lagringskvotering (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). For at frigøre plads, slet filer du ikke længere har brug for. Opgradering af din plan øger din samlede kvotering.

Kan jeg annullere når som helst?

Ja. Annuller dit abonnement via faktureringsportalen — ingen binding. Din konto vender tilbage til det gratis niveau, og eksisterende fastgjorte filer forbliver tilgængelige.

Hvad sker der med mine filer, hvis jeg nedgraderer?

Dine filer forbliver fastgjort til IPFS, men du kan ikke uploade mere, hvis dit nuværende forbrug overstiger den nye plans lagergrænse. Slet filer for at komme under grænsen.

Sikkerhed

Er mine data krypteret?

Alle data er krypteret under transport via TLS/HTTPS. Autentificering bruger JWT-tokens (Cognito) og API-nøgler gemt sikkert. Filindhold på IPFS er ikke krypteret i hvile — IPFS er et offentligt netværk af design.

Er det sikkert at bruge API-nøgler i min serverkode?

Ja. API-nøgler er designet til serverside-brug. Eksponer dem aldrig i klientkode. For klientside-filadgang, brug gateway-tokens (gwt_), som er skrivebeskyttede.

Support

Hvordan får jeg hjælp?

Send en e-mail til info@ipfs.ninja eller tjek dokumentationen API-referencen.

Er der et SLA?

Vi stræber efter høj tilgængelighed, men tilbyder ikke et formelt SLA på nuværende tidspunkt. Tjenesten leveres på et "som den er"-grundlag.