IPFS Ninja

Jednoducho nahrávajte obrázky, PDF a JSON súbory na IPFS a získajte trvalý identifikátor obsahu (CID) s okamžitým prístupom cez gateway.

Čo je IPFS?

InterPlanetary File System (IPFS) je decentralizovaný peer-to-peer úložný protokol. IPFS rozdeľuje súbory na menšie časti, distribuuje ich po sieti a každému súboru priraďuje jedinečný identifikátor obsahu (CID) na základe jeho obsahu.

To znamená:

• Distribuované úložisko — vaše súbory sú uložené na viacerých uzloch pre lepšiu spoľahlivosť.
• Adresovanie obsahu — CID je odvodený z obsahu súboru samotného, čo zabezpečuje nemennosť.
• Sieťová dostupnosť — ktokoľvek s CID môže súbor získať z akéhokoľvek IPFS uzla.

Čo IPFS Ninja robí

IPFS Ninja je spravovaná služba, ktorá vám umožňuje nahrávať súbory a pripínať existujúci obsah na IPFS prostredníctvom jednoduchého REST API. Nie je potrebné prevádzkovať vlastný IPFS uzol.

• Nahrávanie nových súborov — odošlite akýkoľvek súbor cez POST /upload/new a získajte trvalý CID
• Pripínanie existujúcich CID — už máte obsah na IPFS? Pripnite ho k nášmu clusteru cez POST /pin, aby zostal dostupný
• Prístup cez gateway — všetok pripnutý obsah je dostupný na ipfs.ninja/ipfs/<CID> (apex brána obsluhuje iba CID z vášho účtu alebo z iných účtov IPFS Ninja — pozri Prístup k bráne nižšie)
• Vlastné metadáta — pripojte páry kľúč-hodnota k nahraniam a pripnutiam pre organizáciu a filtrovanie
• Podpísané tokeny na nahrávanie — generujte časovo obmedzené tokeny pre nahrávanie na strane klienta bez odhalenia vášho API kľúča
• IPNS premenlivé mená — vytvárajte stabilné mená, ktoré odkazujú na meniace sa CID cez IPNS API, až 10 mien na účet
• Optimalizácia obrázkov — meňte veľkosť, prevádzajte a komprimujte obrázky za behu pomocou parametrov URL gateway

Ovládací panel

Sledujte nahrávanie, úložisko a šírku pásma gateway z vášho osobného ovládacieho panelu. Ovládací panel vám tiež umožňuje ovládať väčšinu API bez písania kódu:

• Nahrávanie ťahaním a pustením — súbory, priečinky (zabalené do UnixFS adresára priamo v prehliadači) alebo .car archívy
• Premenovanie súborov po nahraní; popis sa automaticky vyplní z názvu súboru pri výbere
• Snímka priečinka na získanie jedného CID adresára pre všetok jeho obsah
• Konfigurácia S3 CORS pre jednotlivé buckety cez formulárový editor (pre integrácie s prehliadačovým SDK)
• Správa API kľúčov, tokenov gateway, IPNS mien a nastavení dedikovanej gateway

Prístup cez gateway

Každý nahraný súbor je dostupný cez IPFS Ninja gateway, ktorá slúži ako most medzi decentralizovanou sieťou IPFS a tradičnými webovými prehliadačmi.

URL gateway má tento formát:

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

Apex gateway scope

Apex brána na https://ipfs.ninja/ipfs/<CID> obsluhuje iba CID, ktoré boli nahrané alebo pripnuté registrovaným používateľom IPFS Ninja. Požiadavky na iné CID vracajú HTTP 410 Gone s odkazom na verejné IPFS brány ako ipfs.io alebo dweb.link. Pre obsluhu CID tretej strany cez našu bránu sa zaregistrujte zadarmo a najprv vykonajte POST /pin na svoj účet.

TIP

Vaše súbory sú tiež dostupné z akejkoľvek verejnej IPFS gateway (napr. dweb.link, w3s.link) pomocou rovnakého CID — sieť IPFS je decentralizovaná.

Všetky platené plány získajú dedikovanú gateway na vlastnej subdoméne (<slug>.gw.ipfs.ninja), ktorá obsluhuje iba súbory pripnuté k ich účtu — s voliteľným riadením prístupu na základe tokenov a obmedzeniami pôvodu. Dedikovaná gateway je odporúčaná URL pre produkčné vkladanie (videá, NFT prehliadače, weby).

Podporované typy súborov

Typ	Formáty	Vstup
JSON	Akýkoľvek platný JSON objekt alebo pole	string / object
Obrázky	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Štandardné PDF dokumenty	base64
HTML	HTML dokumenty	base64
Akýkoľvek	Akýkoľvek súbor (binárny, textový, video atď.)	base64

Všetky typy súborov sú akceptované. Typ je automaticky detegovaný a zaznamenaný pre vašu referenciu.

Security

Odpovede gateway obsahujú bezpečnostné hlavičky (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), ktoré zabraňujú prehliadačom spúšťať skripty v obsluhovanom obsahu.