Vanliga frågor

Vanliga frågor om IPFS Ninja.

Allmänt

Vad är IPFS Ninja?

IPFS Ninja är en hanterad IPFS-fästningstjänst. Du laddar upp valfri fil via ett enkelt REST API, eller fäster befintliga CID:er från IPFS-nätverket. Varje fil får en permanent innehållsidentifierare (CID) och är åtkomlig via vår gateway på ipfs.ninja/ipfs/<CID>.

Vilka filtyper stöds?

Alla filtyper stöds. JSON-objekt och arrayer kan skickas direkt. Alla andra filer (bilder, PDF, HTML, video, ljud, binära) skickas som base64-kodat innehåll.

Finns det en filstorleksbegränsning?

Individuella uppladdningar begränsas av din plans lagringsutrymme. Det finns ingen filstorleksbegränsning utöver ditt tillgängliga lagringsutrymme.

Kan jag fästa innehåll som redan finns på IPFS?

Ja. Använd POST /pin med valfri giltig CID. Vårt kluster hämtar innehållet från IPFS-nätverket och fäster det till ditt konto. Se Pinning API-dokumentationen för detaljer.

Hur lång tid tar fästning?

Det beror på filstorlek och hur många IPFS-noder som har innehållet. Små, väldistribuerade filer fästs på sekunder. Stort eller sällan fäst innehåll kan ta några minuter. Fästningsendpointen returnerar omedelbart med status pinning — polla GET /pin/:cid för att kontrollera framsteg.

Vad händer om en CID inte kan hittas?

Statusen ändras till failed. Det betyder att CID:n antingen är ogiltig eller att innehållet inte längre är tillgängligt på någon nåbar IPFS-nod.

Är data som laddas upp till IPFS offentlig?

Ja. Allt innehåll fäst på IPFS är offentligt åtkomligt via dess CID genom vilken IPFS-gateway som helst. Om du behöver privat åtkomst, använd en dedikerad gateway med tokenkravsläge — detta begränsar åtkomsten genom din gateway, även om innehållet förblir tillgängligt på det bredare IPFS-nätverket.

Kommer mina filer att finnas kvar på IPFS om jag avbryter mitt konto?

Vi tar bort fästningen av dina filer från våra noder när du avbryter. Om andra IPFS-noder har cachat ditt innehåll kan det fortfarande vara åtkomligt. Dock, utan aktiv fästning, kommer filer så småningom att tas bort genom skräpinsamling över nätverket.

Autentisering & API

Hur autentiserar jag API-begäranden?

Skicka din API-nyckel via X-Api-Key-rubriken. Generera nycklar från API-nycklar-sidan i din instrumentpanel.

Finns det API-hastighetsbegränsningar?

Nej. IPFS Ninja har inga hastighetsbegränsningar för API-begäranden. Du kan göra så många begäranden du behöver med vilken plan som helst.

Förfaller API-nycklar?

Nej. API-nycklar är giltiga tills du tar bort dem. Du kan skapa flera nycklar och återkalla dem individuellt.

Vad är skillnaden mellan API-nycklar och gateway-token?

API-nycklar (bws_) har full åtkomst — uppladdning, borttagning, listning av filer. Gateway-token (gwt_) är skrivskyddade och kan bara komma åt filer genom din dedikerade gateway. Gateway-token är säkra att bädda in i frontend-appar.

Dedikerade gateways

Vad är en dedikerad gateway?

En privat IPFS-gateway på din egen subdomän (t.ex. abc123.gw.ipfs.ninja) som bara serverar filer fästa till ditt konto. Till skillnad från den offentliga gatewayen kommer den inte att lösa CID:er från andra användare.

Vilka planer inkluderar en dedikerad gateway?

Dedikerade gateways är tillgängliga med Nirvana-planen (29$/månad), som inkluderar 50 GB/månad gateway-bandbredd.

Kan jag begränsa vem som kommer åt min gateway?

Ja. Du kan aktivera tokenkravsläge (kräver en gwt_-token vid varje begäran) och/eller ställa in en IP-vitlista (upp till 100 adresser).

Kan jag begränsa min gateway efter ursprung/domän?

Ja. Konfigurera allowedOrigins i dina gateway-inställningar med en lista över HTTPS-ursprung. Bara webbläsarbegäranden från dessa ursprung tillåts. Icke-webbläsarbegäranden (utan Origin-rubrik) passerar utan begränsning. En tom lista tillåter alla ursprung.

Vad är signerade uppladdningstoken?

Signerade uppladdningstoken är tidsbegränsade autentiseringsuppgifter för klientuppladdningar. Du genererar dem på din server med POST /upload/signed-url och skickar dem till webbläsare eller mobilappar. Klienten autentiserar med Authorization: Signed <token> istället för att exponera din API-nyckel. Varje token spårar användning och förfaller automatiskt. Se dokumentationen för signerade token för detaljer.

Kan jag optimera bilder som serveras från IPFS?

Ja. Använd GET /image/:cid med frågeparametrar som w, h, format och quality för att ändra storlek, konvertera och komprimera bilder direkt. Svar cachas baserat på den innehållsadresserade CID:n. Fungerar med alla planer. Se Bildoptimering.

Kan jag bifoga metadata till filer?

Ja. Inkludera ett metadata-objekt med upp till 10 nyckel-värde-par vid uppladdning via POST /upload/new eller fästning via POST /pin. Metadata returneras i fillistningar och fildetaljendpointen. Se dokumentationen för Filer och Fästning.

Fakturering & planer

Finns det en gratis plan?

Ja. Dharma-planen är gratis för alltid — 1 GB lagring, obegränsade API-begäranden, inget kreditkort krävs.

Finns det bandbreddsavgifter?

Inga bandbreddsavgifter för API-begäranden för någon plan. Dedikerad gateway-bandbredd (Nirvana-planen) inkluderar 50 GB/månad. När gränsen nås blockeras gateway-begäranden till nästa månad.

Återställs lagringsutrymmet?

Lagringsutrymmet återställs inte. Din plan inkluderar en total lagringskvot (1 GB / 10 GB / 100 GB). För att frigöra utrymme, ta bort filer du inte längre behöver. Uppgradering av din plan ökar din totala kvot.

Kan jag avbryta när som helst?

Ja. Avbryt din prenumeration via faktureringsportalen — ingen inlåsning. Ditt konto återgår till den gratis nivån och befintliga fästa filer förblir åtkomliga.

Vad händer med mina filer om jag nedgraderar?

Dina filer förblir fästa på IPFS, men du kan inte ladda upp mer om din nuvarande användning överstiger den nya planens lagringsgräns. Ta bort filer för att komma under gränsen.

Säkerhet

Är mina data krypterade?

All data krypteras under transport via TLS/HTTPS. Autentisering använder JWT-token (Cognito) och API-nycklar som lagras säkert. Filinnehåll på IPFS krypteras inte i vila — IPFS är ett offentligt nätverk designmässigt.

Är det säkert att använda API-nycklar i serverkod?

Ja. API-nycklar är designade för serversideanvändning. Exponera dem aldrig i klientkod. För klientsidig filåtkomst, använd gateway-token (gwt_) som är skrivskyddade.

Support

Hur får jag hjälp?

Maila info@ipfs.ninja eller se API-referens-dokumentationen.

Finns det ett SLA?

Vi strävar efter hög tillgänglighet men erbjuder inte ett formellt SLA för närvarande. Tjänsten tillhandahålls i befintligt skick.