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>.

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.

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å Nirvana-planen ($29/md), som inkluderer 50 GB/måned gateway-båndbredde.

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 båndbreddegebyrer på API-forespørgsler for nogen plan. Dedikeret gateway-båndbredde (Nirvana-planen) inkluderer 50 GB/måned. Når grænsen nås, blokeres gateway-forespørgsler indtil næste måned.

Nulstilles lagring?

Lagring nulstilles ikke. Din plan inkluderer en total lagringskvotering (1 GB / 10 GB / 100 GB). 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 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.