FAQ

Pogosta vprašanja o IPFS Ninja.

Splošno

Kaj je IPFS Ninja?

IPFS Ninja je upravljana storitev pripenjanja IPFS. Naložite katero koli datoteko prek preprostega REST API-ja ali pripnete obstoječe CID-e iz IPFS omrežja. Vsaka datoteka dobi trajen identifikator vsebine (CID) in je dostopna prek našega prehoda na ipfs.ninja/ipfs/<CID>.

Katere vrste datotek so podprte?

Vse vrste datotek so podprte. JSON objekti in polja se lahko pošljejo neposredno. Vse ostale datoteke (slike, PDF-ji, HTML, video, avdio, binarne datoteke) se pošljejo kot base64-kodirana vsebina.

Ali obstaja omejitev velikosti datoteke?

Posamezna nalaganja so omejena s shrambo vašega načrta. Ni omejitve velikosti na datoteko poleg vaše razpoložljive shrambe.

Ali lahko pripnem vsebino, ki že obstaja na IPFS-u?

Da. Uporabite POST /pin s katerim koli veljavnim CID. Naš grozd bo pridobil vsebino iz IPFS omrežja in jo pripel na vaš račun. Podrobnosti najdete v dokumentaciji Pinning API-ja.

Kako dolgo traja pripenjanje?

Odvisno od velikosti datoteke in števila IPFS vozlišč, ki imajo vsebino. Majhne, dobro porazdeljene datoteke se pripnejo v sekundah. Velika ali redko pripeta vsebina lahko traja nekaj minut. Končna točka za pripenjanje takoj vrne stanje pinning — poizvedujte GET /pin/:cid za preverjanje napredka.

Kaj se zgodi, če CID ni mogoče najti?

Stanje se spremeni v failed. To pomeni, da je CID neveljaven ali da vsebina ni več na voljo na nobenem dosegljivem IPFS vozlišču.

Ali so podatki, naloženi na IPFS, javni?

Da. Vsa vsebina, pripeta na IPFS, je javno dostopna prek svojega CID-a prek katerega koli IPFS prehoda. Če potrebujete zaseben dostop, uporabite namenski prehod z načinom zahtevanja žetona — to omeji dostop prek vašega prehoda, čeprav vsebina ostane na voljo na širšem IPFS omrežju.

Bodo moje datoteke ostale na IPFS-u, če odpovem račun?

Ob odpovedi odpnemo vaše datoteke iz naših vozlišč. Če so druga IPFS vozlišča shranila vašo vsebino v predpomnilnik, lahko ostane dostopna. Vendar bodo brez aktivnega pripenjanja datoteke sčasoma odstranjene z zbiranjem smeti v celotnem omrežju.

Avtentikacija in API

Kako avtenticiram API zahteve?

Posredujte svoj API ključ prek glave X-Api-Key. Ključe ustvarite s strani API ključi na vaši nadzorni plošči.

Ali obstajajo omejitve hitrosti API-ja?

Ne. IPFS Ninja ne nalaga omejitev hitrosti za API zahteve. Na katerem koli načrtu lahko pošljete toliko zahtev, kolikor potrebujete.

Ali API ključi potečejo?

Ne. API ključi veljajo, dokler jih ne izbrišete. Ustvarite lahko več ključev in jih posamezno prekličete.

Kakšna je razlika med API ključi in žetoni prehoda?

API ključi (bws_) imajo poln dostop — nalaganje, brisanje, seznam datotek. Žetoni prehoda (gwt_) so samo za branje in lahko dostopajo do datotek samo prek vašega namenskega prehoda. Žetone prehoda je varno vgraditi v frontend aplikacije.

Namenski prehodi

Kaj je namenski prehod?

Zaseben IPFS prehod na vaši lastni poddomeni (npr. abc123.gw.ipfs.ninja), ki streže samo datoteke, pripete na vaš račun. Za razliko od javnega prehoda ne bo razreševal CID-ov drugih uporabnikov.

Kateri načrti vključujejo namenski prehod?

Namenski prehodi so na voljo pri načrtu Nirvana (29 $/mesec), ki vključuje 50 GB/mesec pasovne širine prehoda.

Ali lahko omejim, kdo dostopa do mojega prehoda?

Da. Omogočite lahko način zahtevanja žetona (zahteva žeton gwt_ ob vsakem zahtevku) in/ali nastavite belo listo IP naslovov (do 100 naslovov).

Ali lahko omejim svoj prehod po izvoru/domeni?

Da. Nastavite allowedOrigins v vaših nastavitvah prehoda s seznamom HTTPS izvorov. Dovoljeni bodo samo zahtevi brskalnikov s teh izvorov. Zahtevi zunaj brskalnika (brez glave Origin) prehajajo brez omejitev. Prazen seznam dovoljuje vse izvore.

Kaj so podpisani žetoni za nalaganje?

Podpisani žetoni za nalaganje so časovno omejene poverilnice za nalaganje na strani odjemalca. Ustvarite jih na svojem strežniku z uporabo POST /upload/signed-url in jih posredujete brskalnikom ali mobilnim aplikacijam. Odjemalec se avtenticira z Authorization: Signed <token> namesto razkrivanja vašega API ključa. Vsak žeton sledi uporabi in samodejno poteče. Podrobnosti najdete v dokumentaciji Podpisanih žetonov.

Ali lahko optimiziram slike, strežene iz IPFS-a?

Da. Uporabite GET /image/:cid s parametri poizvedbe, kot so w, h, format in quality, za spreminjanje velikosti, pretvorbo in stiskanje slik sproti. Odgovori so shranjeni v predpomnilniku na podlagi CID-a, naslavljenega z vsebino. Deluje na vseh načrtih. Glejte Optimizacija slik.

Ali lahko pripnem metapodatke datotekam?

Da. Vključite objekt metadata z do 10 pari ključ-vrednost pri nalaganju prek POST /upload/new ali pripenjanju prek POST /pin. Metapodatki so vrnjeni v seznamih datotek in na končni točki podrobnosti datoteke. Glejte dokumentacijo Datoteke in Pripenjanje.

Zaračunavanje in načrti

Ali obstaja brezplačen načrt?

Da. Načrt Dharma je za vedno brezplačen — 1 GB shrambe, neomejeni API zahtevi, brez potrebe po kreditni kartici.

Ali obstajajo stroški pasovne širine?

Brez stroškov pasovne širine za API zahteve na katerem koli načrtu. Pasovna širina namenskega prehoda (načrt Nirvana) vključuje 50 GB/mesec. Ko je omejitev dosežena, so zahtevi prehoda blokirani do naslednjega meseca.

Ali se shramba ponastavi?

Shramba se ne ponastavi. Vaš načrt vključuje skupno kapaciteto shrambe (1 GB / 10 GB / 100 GB). Za sprostitev prostora izbrišite datoteke, ki jih ne potrebujete več. Nadgradnja načrta poveča vašo skupno kapaciteto.

Ali lahko kadarkoli odpovem?

Da. Odpovejte naročnino prek portala za zaračunavanje — brez obveznosti. Vaš račun se vrne na brezplačno raven, obstoječe pripete datoteke pa ostanejo dostopne.

Kaj se zgodi z mojimi datotekami, če znižam načrt?

Vaše datoteke ostanejo pripete na IPFS-u, vendar ne morete nalagati več, če vaša trenutna uporaba presega omejitev shrambe novega načrta. Izbrišite datoteke, da se vrnete pod omejitev.

Varnost

Ali so moji podatki šifrirani?

Vsi podatki so šifrirani med prenosom prek TLS/HTTPS. Avtentikacija uporablja JWT žetone (Cognito) in varno shranjene API ključe. Vsebina datotek na IPFS-u ni šifrirana v mirovanju — IPFS je po zasnovi javno omrežje.

Ali je varno uporabljati API ključe v mojem strežniškem kodu?

Da. API ključi so zasnovani za uporabo na strani strežnika. Nikoli jih ne izpostavljajte v kodi na strani odjemalca. Za dostop do datotek na strani odjemalca uporabite žetone prehoda (gwt_), ki so samo za branje.

Podpora

Kako dobim pomoč?

Pišite na info@ipfs.ninja ali si oglejte dokumentacijo Referenca API-ja.

Ali obstaja SLA?

Prizadevamo si za visoko razpoložljivost, vendar trenutno ne ponujamo formalnega SLA. Storitev je zagotovljena na podlagi „takšna, kot je".