IPFS Ninja

Snadno nahrávejte obrázky, PDF a JSON soubory na IPFS a získejte trvalý identifikátor obsahu (CID) s okamžitým přístupem přes gateway.

Co je IPFS?

InterPlanetary File System (IPFS) je decentralizovaný peer-to-peer úložný protokol. IPFS rozděluje soubory na menší části, distribuuje je po síti a každému souboru přiřadí jedinečný identifikátor obsahu (CID) na základě jeho obsahu.

To znamená:

• Distribuované úložiště — vaše soubory jsou uloženy na více uzlech pro lepší spolehlivost.
• Adresování obsahu — CID je odvozen z obsahu souboru samotného, což zajišťuje neměnnost.
• Síťová dostupnost — kdokoli s CID může soubor získat z jakéhokoli IPFS uzlu.

Co IPFS Ninja dělá

IPFS Ninja je spravovaná služba, která vám umožňuje nahrávat soubory a připínat existující obsah na IPFS prostřednictvím jednoduchého REST API. Není potřeba provozovat vlastní IPFS uzel.

• Nahrávání nových souborů — odešlete jakýkoli soubor přes POST /upload/new a získejte trvalý CID
• Připínání existujících CID — již máte obsah na IPFS? Připněte ho k našemu clusteru přes POST /pin, aby zůstal dostupný
• Přístup přes gateway — veškerý připnutý obsah je dostupný na ipfs.ninja/ipfs/<CID>
• Vlastní metadata — připojte páry klíč-hodnota k nahráním a připnutím pro organizaci a filtrování
• Podepsané tokeny pro nahrávání — generujte časově omezené tokeny pro nahrávání na straně klienta bez odhalení vašeho API klíče
• IPNS proměnná jména — vytvářejte stabilní jména, která odkazují na měnící se CID přes IPNS API, až 10 jmen na účet
• Optimalizace obrázků — měňte velikost, převádějte a komprimujte obrázky za běhu pomocí parametrů URL gateway

Řídicí panel

Sledujte nahrávání, úložiště a šířku pásma gateway z vašeho osobního řídicího panelu.

Přístup přes gateway

Každý nahraný soubor je dostupný přes IPFS Ninja gateway, která slouží jako most mezi decentralizovanou sítí IPFS a tradičními webovými prohlížeči.

URL gateway má tento formát:

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

TIP

Vaše soubory jsou také dostupné z jakékoli veřejné IPFS gateway (např. dweb.link, w3s.link) pomocí stejného CID — síť IPFS je decentralizovaná.

Uživatelé plánu Nirvana získají dedikovanou gateway na vlastní subdoméně (<slug>.gw.ipfs.ninja), která obsluhuje pouze soubory připnuté k jejich účtu — s volitelným řízením přístupu na základě tokenů a omezeními původu.

Podporované typy souborů

Typ	Formáty	Vstup
JSON	Jakýkoli platný JSON objekt nebo pole	string / object
Obrázky	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Standardní PDF dokumenty	base64
HTML	HTML dokumenty	base64
Jakýkoli	Jakýkoli soubor (binární, textový, video atd.)	base64

Všechny typy souborů jsou přijímány. Typ je automaticky detekován a zaznamenán pro vaši referenci.

Bezpečnost

Odpovědi gateway obsahují bezpečnostní hlavičky (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), které zabraňují prohlížečům spouštět skripty v obsluhovaném obsahu.

Limity velikosti

Limit	Hodnota
Max. velikost požadavku	6 MB (limit API Gateway)
Celkové úložiště (Dharma)	1 GB
Celkové úložiště (Bodhi)	10 GB
Celkové úložiště (Nirvana)	100 GB

Případy použití

NFT metadata a aktiva

Ukládejte NFT metadata JSON a přidružené obrázky s trvalými, neměnnými CID.

Hosting statických zdrojů

Hostujte obrázky, dokumenty a datové soubory pro webové a mobilní aplikace.

Ověřitelné sdílení dat

Sdílejte data s adresováním obsahu a prokazatelným původem — příjemci mohou ověřit, že nebylo nic pozměněno.