IPFS Ninja

Egyszerűen töltsön fel képeket, PDF-eket és JSON fájlokat az IPFS-re, és kapjon állandó tartalmazonosí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 tartalmazonosítót (CID) rendel a tartalom alapján.

Ez azt jelenti:

• Elosztott tárolás — a fájljai több csomóponton vannak tárolva 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ókodban 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év
• 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.

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 átjárónkon keresztül regisztrálj ingyen, és először futtass POST /pin-t a fiókodra.

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.

A Nirvana csomag felhasználói dedikált gateway-t kapnak 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.

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	Szabványos PDF dokumentumok	base64
HTML	HTML dokumentumok	base64
Bármilyen	Bármilyen fájl (bináris, szöveg, videó stb.)	base64

Minden fájltípus elfogadott. A típus automatikusan felismerésre kerül é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.