IPFS Ninja

Lengvai įkelkite vaizdus, PDF failus ir JSON failus į IPFS ir gaukite nuolatinį turinio identifikatorių (CID) su momentine gateway prieiga.

Kas yra IPFS?

InterPlanetary File System (IPFS) yra decentralizuotas, lygiarangis saugojimo protokolas. IPFS suskaido failus į mažesnes dalis, paskirsto juos tinkle ir kiekvienam failui priskiria unikalų turinio identifikatorių (CID) pagal jo turinį.

Tai reiškia:

• Paskirstyta saugykla — jūsų failai saugomi keliuose mazguose patikimumui užtikrinti.
• Turinio adresavimas — CID išvedamas iš paties failo turinio, užtikrinant nekintamumą.
• Visos tinklo prieiga — bet kas, turintis CID, gali gauti failą iš bet kurio IPFS mazgo.

Ką daro IPFS Ninja

IPFS Ninja yra valdoma paslauga, leidžianti įkelti failus ir prisegti esamą turinį IPFS per paprastą REST API. Nereikia paleisti savo IPFS mazgo.

• Įkelkite naujus failus — siųskite bet kokį failą per POST /upload/new ir gaukite nuolatinį CID
• Prisekite esamus CID — jau turite turinį IPFS? Prisekite jį prie mūsų klasterio per POST /pin, kad užtikrintumėte jo prieinamumą
• Prieiga per gateway — visas prisegtas turinys pasiekiamas ipfs.ninja/ipfs/<CID> (apex gateway aptarnauja tik CID iš jūsų paskyros arba kitų IPFS Ninja paskyrų — žr. Gateway prieiga žemiau)
• Pritaikyti metaduomenys — pridėkite rakto-reikšmės poras prie įkėlimų ir prisegimų organizavimui ir filtravimui
• Pasirašyti įkėlimo tokenai — generuokite riboto laiko tokenus kliento pusės įkėlimams neatskleidžiant savo API rakto
• IPNS kintami vardai — kurkite stabilius vardus, nurodančius kintančius CID per IPNS API, iki 10 vardų vienai paskyrai
• Vaizdo optimizavimas — keiskite dydį, konvertuokite ir suspauskite vaizdus iš karto per gateway URL parametrus

Prietaisų skydelis

Sekite įkėlimus, saugyklą ir gateway pralaidumą iš savo asmeninio prietaisų skydelio. Prietaisų skydelis taip pat leidžia valdyti didžiąją dalį API be jokio kodo rašymo:

• Vilkimo ir numetimo įkėlimas — failai, aplankai (supakuojami į UnixFS katalogą jūsų naršyklėje) arba .car archyvai
• Pervadinkite failus po įkėlimo; aprašymas automatiškai užpildomas iš failo pavadinimo pasirinkus
• Padarykite momentinę nuotrauką (snapshot) aplankui, kad gautumėte vieną katalogo CID visam jo turiniui
• Sukonfigūruokite S3 CORS kiekvienam bucket per formos redaktorių (naršyklės SDK integracijoms)
• Valdykite API raktus, gateway tokenus, IPNS vardus ir dedikuoto gateway nustatymus

Gateway prieiga

Kiekvienas įkeltas failas pasiekiamas per IPFS Ninja gateway, kuris veikia kaip tiltas tarp decentralizuoto IPFS tinklo ir tradicinių naršyklių.

Gateway URL seka šį šabloną:

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

Apex gateway apimtis

Apex gateway adresu https://ipfs.ninja/ipfs/<CID> aptarnauja tik CID, kuriuos įkėlė ar prisegė registruotas IPFS Ninja vartotojas. Užklausos kitiems CID grąžina HTTP 410 Gone su nuoroda į viešus IPFS gateway, tokius kaip ipfs.io ar dweb.link. Norėdami aptarnauti trečiosios šalies CID per mūsų gateway, užsiregistruokite nemokamai ir pirma atlikite POST /pin į savo paskyrą.

TIP

Jūsų failai taip pat pasiekiami per bet kurį viešą IPFS gateway (pvz., dweb.link, w3s.link) su tuo pačiu CID — IPFS tinklas yra decentralizuotas.

Visi mokami planai gauna dedikuotą gateway savo poddomenyje (<slug>.gw.ipfs.ninja), kuris aptarnauja tik prie jų paskyros prisegtus failus — su pasirenkama tokenais pagrįsta prieigos kontrole ir kilmės apribojimais. Dedikuotas gateway yra rekomenduojamas URL produkciniam įterpimui (vaizdo įrašai, NFT peržiūros, svetainės).

Palaikomi failų tipai

Tipas	Formatai	Įvestis
JSON	Bet koks galiojantis JSON objektas ar masyvas	string / object
Vaizdai	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Standartiniai PDF dokumentai	base64
HTML	HTML dokumentai	base64
Visi	Bet koks failas (dvejetainis, tekstas, vaizdo įrašas ir kt.)	base64

Visi failų tipai priimami. Tipas automatiškai nustatomas ir registruojamas jūsų nuorodai.

Saugumas

Gateway atsakymai apima saugumo antraštes (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), kurios neleidžia naršyklėms vykdyti skriptų pateikiamame turinyje.