IPFS Ninja

Jednostavno prenesite slike, PDF-ove i JSON datoteke na IPFS i dobijte trajni identifikator sadržaja (CID) s trenutnim pristupom putem gatewaya.

Što je IPFS?

InterPlanetary File System (IPFS) je decentralizirani peer-to-peer protokol za pohranu. IPFS rastavlja datoteke na manje dijelove, distribuira ih po mreži i svakoj datoteci dodjeljuje jedinstveni identifikator sadržaja (CID) na temelju njezina sadržaja.

To znači:

• Distribuirana pohrana — vaše datoteke pohranjene su na više čvorova za poboljšanu pouzdanost.
• Adresiranje sadržaja — CID je izveden iz samog sadržaja datoteke, čime se osigurava nepromjenjivost.
• Mrežna dostupnost — svatko s CID-om može dohvatiti datoteku s bilo kojeg IPFS čvora.

Što IPFS Ninja radi

IPFS Ninja je upravljana usluga koja vam omogućuje prijenos datoteka i prikvačivanje postojećeg sadržaja na IPFS putem jednostavnog REST API-ja. Nije potrebno pokretati vlastiti IPFS čvor.

• Prijenos novih datoteka — pošaljite bilo koju datoteku putem POST /upload/new i dobijte trajni CID
• Prikvačivanje postojećih CID-ova — već imate sadržaj na IPFS-u? Prikvačite ga na naš klaster putem POST /pin kako bi ostao dostupan
• Pristup putem gatewaya — sav prikvačeni sadržaj dostupan je na ipfs.ninja/ipfs/<CID> (apex pristupnik poslužuje samo CID-ove iz vašeg računa ili iz drugih IPFS Ninja računa — pogledajte Pristup pristupniku ispod)
• Prilagođeni metapodaci — priložite parove ključ-vrijednost prijenosima i prikvačenjima za organizaciju i filtriranje
• Potpisani tokeni za prijenos — generirajte vremenski ograničene tokene za prijenos na strani klijenta bez otkrivanja vašeg API ključa
• IPNS promjenjiva imena — stvorite stabilna imena koja upućuju na promjenjive CID-ove putem IPNS API-ja, do 10 imena po računu
• Optimizacija slika — mijenjajte veličinu, pretvarajte i komprimirajte slike u hodu pomoću parametara URL-a gatewaya

Nadzorna ploča

Pratite prijenose, pohranu i propusnost gatewaya s vaše osobne nadzorne ploče. Nadzorna ploča vam također omogućuje upravljanje većinom API-ja bez pisanja koda:

• Prijenos povlačenjem (drag-and-drop) — datoteke, mape (pakirane u UnixFS direktorij u vašem pregledniku) ili .car arhive
• Preimenujte datoteke nakon prijenosa; opis se automatski popunjava prema nazivu datoteke pri odabiru
• Snimite (snapshot) mapu kako biste dobili jedinstveni CID direktorija za sav sadržaj unutar nje
• Konfigurirajte S3 CORS po spremniku putem uređivača obrazaca (za integracije s preglednik SDK-ovima)
• Upravljajte API ključevima, gateway tokenima, IPNS imenima i postavkama namjenskog gatewaya

Pristup putem gatewaya

Svaka prenesena datoteka dostupna je putem IPFS Ninja gatewaya, koji služi kao most između decentralizirane IPFS mreže i tradicionalnih web preglednika.

URL gatewaya slijedi ovaj obrazac:

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

Opseg apex pristupnika

Apex pristupnik na https://ipfs.ninja/ipfs/<CID> poslužuje samo CID-ove koje je prenio ili prikvačio registrirani korisnik IPFS Ninja. Zahtjevi za druge CID-ove vraćaju HTTP 410 Gone s pokazivačem na javne IPFS pristupnike kao što su ipfs.io ili dweb.link. Da biste posluživali CID treće strane putem našeg pristupnika, registrirajte se besplatno i prvo izvršite POST /pin na svoj račun.

TIP

Vaše datoteke su također dostupne s bilo kojeg javnog IPFS gatewaya (npr. dweb.link, w3s.link) koristeći isti CID — IPFS mreža je decentralizirana.

Svi plaćeni planovi dobivaju namjenski gateway na vlastitoj poddomeni (<slug>.gw.ipfs.ninja) koji poslužuje samo datoteke prikvačene na njihov račun — s opcionalnom kontrolom pristupa na temelju tokena i ograničenjima izvora. Namjenski gateway je preporučeni URL za produkcijsko ugrađivanje (videa, NFT preglednika, web stranica).

Podržani tipovi datoteka

Tip	Formati	Unos
JSON	Bilo koji valjani JSON objekt ili polje	string / object
Slike	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Standardni PDF dokumenti	base64
HTML	HTML dokumenti	base64
Bilo koji	Bilo koja datoteka (binarna, tekst, video itd.)	base64

Svi tipovi datoteka su prihvaćeni. Tip se automatski prepoznaje i bilježi za vašu referencu.

Sigurnost

Odgovori gatewaya uključuju sigurnosna zaglavlja (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) koja sprječavaju preglednike da izvršavaju skripte u isporučenom sadržaju.