IPFS Ninja

Egyszerűen töltsön fel képeket, PDF-eket és JSON fájlokat az IPFS-re, és kapjon állandó tartalomazonosítót (CID) azonnali gateway-hozzáféréssel.

Mi az IPFS?

Az InterPlanetary File System (IPFS) egy decentralizált, peer-to-peer tárolási protokoll. Az IPFS a fájlokat kisebb darabokra bontja, elosztja a hálózaton, és minden fájlhoz egyedi tartalomazonosítót (CID) rendel a tartalma alapján.

Ez azt jelenti:

• Elosztott tárolás — a fájljai több csomóponton kerülnek tárolásra a jobb megbízhatóság érdekében.
• Tartalom-alapú címzés — a CID magából a fájl tartalmából származik, ami biztosítja a változtathatatlanságot.
• Hálózatszintű elérhetőség — bárki, aki rendelkezik a CID-del, lekérheti a fájlt bármely IPFS csomópontról.

Mit csinál az IPFS Ninja

Az IPFS Ninja egy menedzselt szolgáltatás, amely lehetővé teszi fájlok feltöltését és meglévő tartalom rögzítését az IPFS-en egy egyszerű REST API-n keresztül. Nem szükséges saját IPFS csomópontot üzemeltetni.

• Új fájlok feltöltése — küldjön bármilyen fájlt a POST /upload/new végpontra, és kapjon állandó CID-et
• Meglévő CID-ek rögzítése — már van tartalma az IPFS-en? Rögzítse a klaszterünkhöz a POST /pin végponton, hogy elérhető maradjon
• Hozzáférés gateway-en keresztül — minden rögzített tartalom elérhető az ipfs.ninja/ipfs/<CID> címen (az apex átjáró csak a fiókjában vagy más IPFS Ninja fiókokban lévő CID-eket szolgálja ki — lásd Átjáró-hozzáférés alább)
• Egyéni metaadatok — csatoljon kulcs-érték párokat a feltöltésekhez és rögzítésekhez szervezés és szűrés céljából
• Aláírt feltöltési tokenek — generáljon időkorlátozott tokeneket kliensoldali feltöltésekhez az API kulcs felfedése nélkül
• IPNS módosítható nevek — hozzon létre stabil neveket, amelyek változó CID-ekre mutatnak az IPNS API segítségével, fiókonként legfeljebb 10 névvel
• Képoptimalizálás — méretezze át, konvertálja és tömörítse a képeket menet közben a gateway URL paraméterek segítségével

Irányítópult

Kövesse nyomon a feltöltéseket, a tárhelyet és a gateway sávszélességét a személyes irányítópultjáról. Az irányítópult lehetővé teszi azt is, hogy az API nagy részét kód írása nélkül vezérelje:

• Húzd-és-ejtsd feltöltés — fájlok, mappák (a böngészőjében UnixFS könyvtárrá csomagolva) vagy .car archívumok
• Átnevezés — a fájlok feltöltés utáni átnevezése; a leírás automatikusan kitöltődik a fájlnévből kiválasztáskor
• Pillanatkép — egy mappáról, hogy egyetlen könyvtár CID-et kapjon a benne lévő minden fájlhoz
• S3 CORS konfigurálása — bucketenként egy űrlap-szerkesztőn keresztül (böngészős SDK integrációkhoz)
• Kezelés — API kulcsok, gateway tokenek, IPNS nevek és dedikált gateway beállítások

Gateway hozzáférés

Minden feltöltött fájl elérhető az IPFS Ninja gateway-en keresztül, amely hídként szolgál a decentralizált IPFS hálózat és a hagyományos webböngészők között.

A gateway URL a következő mintát követi:

https://ipfs.ninja/ipfs/<CID>

Az apex átjáró hatóköre

A https://ipfs.ninja/ipfs/<CID> címen elérhető apex átjáró csak azokat a CID-eket szolgálja ki, amelyeket egy regisztrált IPFS Ninja felhasználó töltött fel vagy rögzített. Bármely más CID kérésére HTTP 410 Gone választ ad, és nyilvános IPFS átjárókra (ipfs.io, dweb.link) mutat. Harmadik féltől származó CID kiszolgálásához az átjárónkon keresztül regisztráljon ingyen, és először futtasson POST /pin-t a fiókjára.

TIP

A fájljai bármely nyilvános IPFS gateway-ről is elérhetők (pl. dweb.link, w3s.link) ugyanazzal a CID-del — az IPFS hálózat decentralizált.

Minden fizetős csomag kap egy dedikált gateway-t saját aldoménen (<slug>.gw.ipfs.ninja), amely csak a fiókjukhoz rögzített fájlokat szolgálja ki — opcionális token-alapú hozzáférés-vezérléssel és origin korlátozásokkal. A dedikált gateway az ajánlott URL produkciós beágyazáshoz (videók, NFT megjelenítők, webhelyek).

Támogatott fájltípusok

Típus	Formátumok	Bemenet
JSON	Bármilyen érvényes JSON objektum vagy tömb	string / object
Képek	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF-ek	Szabványos PDF dokumentumok	base64
HTML	HTML dokumentumok	base64
Bármi	Bármilyen fájl (bináris, szöveg, videó stb.)	base64

Minden fájltípus elfogadott. A típus automatikus felismerésre és rögzítésre kerül az Ön számára.

Biztonság

A gateway válaszai biztonsági fejléceket tartalmaznak (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), amelyek megakadályozzák, hogy a böngészők szkripteket futtassanak a kiszolgált tartalomban.