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

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.

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

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 båndbreddekostnader på API-forespørsler for noen plan. Dedikert gateway-båndbredde (Nirvana-planen) inkluderer 50 GB/måned. Når grensen nås, blokkeres gateway-forespørsler til neste måned.

Tilbakestilles lagring?

Lagring tilbakestilles ikke. Planen din inkluderer en total lagringskvote (1 GB / 10 GB / 100 GB). 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.