FAQ

Gyakran ismételt kérdések az IPFS Ninja-ról.

Általános

Mi az IPFS Ninja?

Az IPFS Ninja egy menedzselt IPFS rögzítési szolgáltatás. Bármilyen fájlt feltölthet egy egyszerű REST API-n keresztül, vagy rögzíthet meglévő CID-eket az IPFS hálózatról. Minden fájl kap egy állandó tartalmazonosítót (CID), és elérhető a gateway-ünkön az ipfs.ninja/ipfs/<CID> címen.

Milyen fájltípusok támogatottak?

Minden fájltípus támogatott. JSON objektumok és tömbök közvetlenül küldhetők. Minden más fájl (képek, PDF-ek, HTML, videó, audió, bináris fájlok) base64-kódolt tartalomként küldhető.

Van fájlméret-korlát?

Az egyes feltöltéseket a csomag tárolási kerete korlátozza. Nincs fájlonkénti méretkorlát az elérhető tárhelyen túl.

Rögzíthetek már létező IPFS tartalmat?

Igen. Használja a POST /pin végpontot bármilyen érvényes CID-del. Klaszterünk lekéri a tartalmat az IPFS hálózatról és rögzíti a fiókjához. Részletekért lásd a Pinning API dokumentációt.

Mennyi ideig tart a rögzítés?

A fájl méretétől és attól függ, hány IPFS csomópont rendelkezik a tartalommal. Kis, jól elosztott fájlok másodpercek alatt rögzítésre kerülnek. Nagy vagy ritkán rögzített tartalom néhány percet vehet igénybe. A rögzítési végpont azonnal visszatér pinning állapottal -- a GET /pin/:cid lekérdezésével ellenőrizheti a folyamatot.

Mi történik, ha egy CID nem található?

Az állapot failed-re változik. Ez azt jelenti, hogy a CID érvénytelen, vagy a tartalom már nem elérhető egyetlen elérhető IPFS csomóponton sem.

Nyilvánosak az IPFS-re feltöltött adatok?

Igen. Minden IPFS-re rögzített tartalom nyilvánosan elérhető a CID-jén keresztül bármely IPFS gateway-en. Ha privát hozzáférésre van szüksége, használjon dedikált gateway-t token-kötelező módban -- ez korlátozza a hozzáférést a gateway-en keresztül, bár a tartalom továbbra is elérhető marad a tágabb IPFS hálózaton.

Megmaradnak a fájljaim az IPFS-en, ha megszüntetem a fiókomat?

A megszüntetéskor eltávolítjuk a fájljait a csomópontjainkról. Ha más IPFS csomópontok gyorsítótárazták a tartalmát, az továbbra is elérhető lehet. Aktív rögzítés nélkül azonban a fájlokat végül a hálózaton keresztül a szemétgyűjtés eltávolítja.

Hitelesítés és API

Hogyan hitelesítem az API kéréseket?

Adja meg API kulcsát az X-Api-Key fejlécen keresztül. Kulcsokat az irányítópult API kulcsok oldaláról generálhat.

Vannak API sebességkorlátok?

Nem. Az IPFS Ninja nem alkalmaz sebességkorlátokat az API kérésekre. Bármely csomagon annyi kérést küldhet, amennyit szükséges.

Lejárnak az API kulcsok?

Nem. Az API kulcsok mindaddig érvényesek, amíg nem törli őket. Több kulcsot is létrehozhat, és egyenként visszavonhatja őket.

Mi a különbség az API kulcsok és a gateway tokenek között?

Az API kulcsok (bws_) teljes hozzáféréssel rendelkeznek -- feltöltés, törlés, fájlok listázása. A gateway tokenek (gwt_) csak olvasásra alkalmasak, és csak a dedikált gateway-en keresztül férhetnek hozzá a fájlokhoz. A gateway tokeneket biztonságosan beágyazhatja frontend alkalmazásokba.

Dedikált gateway-ek

Mi az a dedikált gateway?

Egy privát IPFS gateway a saját aldoménjén (pl. abc123.gw.ipfs.ninja), amely csak a fiókjához rögzített fájlokat szolgálja ki. A nyilvános gateway-vel ellentétben nem old fel más felhasználók CID-jeit.

Melyik csomagok tartalmazzák a dedikált gateway-t?

A dedikált gateway-ek a Nirvana csomagban érhetők el ($29/hó), amely 50 GB/hó gateway sávszélességet tartalmaz.

Korlátozhatom, ki fér hozzá a gateway-emhez?

Igen. Engedélyezheti a token-kötelező módot (minden kérésnél gwt_ token szükséges) és/vagy beállíthat IP fehérlistát (legfeljebb 100 cím).

Korlátozhatom a gateway-emet forrás/domain szerint?

Igen. Konfigurálja az allowedOrigins beállítást a gateway beállításokban HTTPS források listájával. Csak az adott forrásokból érkező böngészőkérések lesznek engedélyezve. A böngészőn kívüli kérések (Origin fejléc nélkül) korlátozás nélkül átmennek. Az üres lista minden forrást engedélyez.

Mik azok az aláírt feltöltési tokenek?

Az aláírt feltöltési tokenek időkorlátozott hitelesítő adatok kliensoldali feltöltésekhez. A szerverén generálja őket a POST /upload/signed-url segítségével, és átadja böngészőknek vagy mobilalkalmazásoknak. A kliens az Authorization: Signed <token> fejléccel hitelesít az API kulcs felfedése helyett. Minden token nyomon követi a használatot és automatikusan lejár. Részletekért lásd az Aláírt tokenek dokumentációt.

Optimalizálhatom az IPFS-ről kiszolgált képeket?

Igen. Használja a GET /image/:cid végpontot w, h, format és quality lekérdezési paraméterekkel a képek átméretezéséhez, konvertálásához és tömörítéséhez menet közben. A válaszok a tartalom-alapú CID alapján gyorsítótárazásra kerülnek. Minden csomagon működik. Lásd Képoptimalizálás.

Csatolhatok metaadatokat a fájlokhoz?

Igen. Adjon meg egy metadata objektumot legfeljebb 10 kulcs-érték párral feltöltéskor a POST /upload/new vagy rögzítéskor a POST /pin végponton. A metaadatok a fájllistákban és a fájl részletező végponton kerülnek visszaadásra. Lásd a Fájlok és Rögzítés dokumentációt.

Számlázás és csomagok

Van ingyenes csomag?

Igen. A Dharma csomag örökre ingyenes -- 1 GB tárhely, korlátlan API kérések, bankkártya nem szükséges.

Vannak sávszélesség-díjak?

Nincsenek sávszélesség-díjak az API kéréseknél egyetlen csomagnál sem. A dedikált gateway sávszélesség (Nirvana csomag) havi 50 GB-ot tartalmaz. A korlát elérésekor a gateway kérések blokkolásra kerülnek a következő hónapig.

Megújul a tárhely?

A tárhely nem újul meg. A csomagja tartalmaz egy összesített tárhelykeretet (1 GB / 10 GB / 100 GB). Hely felszabadításához törölje a már nem szükséges fájlokat. A csomag frissítése növeli az összesített keretet.

Bármikor lemondhatom?

Igen. Mondja le előfizetését a számlázási portálon keresztül -- nincs kötöttség. Fiókja visszaáll az ingyenes szintre, és a meglévő rögzített fájlok elérhetők maradnak.

Mi történik a fájljaimmal, ha visszalépek?

A fájljai rögzítve maradnak az IPFS-en, de nem tölthet fel többet, ha jelenlegi használata meghaladja az új csomag tárhelykorlátját. Töröljön fájlokat, hogy visszakerüljön a korlát alá.

Biztonság

Titkosítva vannak az adataim?

Minden adat titkosítva van átvitel közben TLS/HTTPS-en keresztül. A hitelesítés JWT tokeneket (Cognito) és biztonságosan tárolt API kulcsokat használ. Az IPFS-en lévő fájltartalom nincs titkosítva nyugalmi állapotban -- az IPFS eleve nyilvános hálózat.

Biztonságos az API kulcsok használata a szerveroldali kódban?

Igen. Az API kulcsok szerveroldali használatra készültek. Soha ne tegye ki őket kliensoldali kódban. A kliensoldali fájl hozzáféréshez használjon gateway tokeneket (gwt_), amelyek csak olvasásra alkalmasak.

Támogatás

Hogyan kaphatok segítséget?

Írjon az info@ipfs.ninja címre, vagy tekintse meg az API referencia dokumentációt.

Van SLA?

Törekszünk a magas rendelkezésre állásra, de jelenleg nem kínálunk formális SLA-t. A szolgáltatás „adott állapotában" kerül biztosításra.