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> (apex brána obsluhuje pouze CID z vašeho účtu nebo z jiných účtů IPFS Ninja — viz Přístup k bráně níže)
• 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. Řídicí panel vám také umožňuje ovládat většinu API bez psaní kódu:

• Nahrávání přetažením — soubory, složky (zabalené v prohlížeči do UnixFS adresáře) nebo archivy .car
• Přejmenování souborů po nahrání; popis se automaticky předvyplní podle názvu souboru při výběru
• Snapshot složky pro získání jednoho adresářového CID pro vše uvnitř
• Konfigurace S3 CORS pro jednotlivé buckety přes editor s formulářem (pro integrace s prohlížečovým SDK)
• Správa API klíčů, tokenů gateway, IPNS jmen a nastavení dedikované gateway

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>

Rozsah apex brány

Apex brána na https://ipfs.ninja/ipfs/<CID> obsluhuje pouze CID, které byly nahrány nebo připnuty registrovaným uživatelem IPFS Ninja. Požadavky na jiné CID vracejí HTTP 410 Gone s odkazem na veřejné IPFS brány jako ipfs.io nebo dweb.link. Pro obsluhu CID třetí strany přes naši bránu se zaregistrujte zdarma a nejprve proveďte POST /pin na svůj účet.

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á.

Všechny placené plány 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. Dedikovaná gateway je doporučenou URL pro produkční vkládání (videa, NFT prohlížeče, weby).

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.