KKK

Korduma kippuvad küsimused IPFS Ninja kohta.

Üldine

Mis on IPFS Ninja?

IPFS Ninja on hallatav IPFS-kinnitamisteenus. Laadite mis tahes faili üles lihtsa REST API kaudu või kinnitate olemasolevaid CID-sid IPFS-võrgust. Iga fail saab püsiva sisuidentifikaatori (CID) ja on kättesaadav meie gateway kaudu aadressil ipfs.ninja/ipfs/<CID>.

Kas ipfs.ninja/ipfs/<CID> teenindab iga IPFS-võrgu CID-i?

Ei. Apex-värav teenindab ainult CID-sid, mille on üles laadinud või kinnitanud IPFS Ninja kasutaja. Tundmatute CID-de päringud tagastavad HTTP 410 Gone koos viitega avalikele IPFS-väravatele (ipfs.io, dweb.link). Kolmanda osapoole CID-i teenindamiseks meie värava kaudu tee esmalt POST /pin oma kontole — pärast kinnitamist on CID kättesaadav nii apex- kui ka pühendatud värava URL-il.

Mis vahe on apex-värava ja pühendatud värava vahel?

Aspekt	Apex ipfs.ninja/ipfs/<CID>	Pühendatud <slug>.gw.ipfs.ninja/ipfs/<CID>
Ulatus	Jagatud kõigi kasutajate vahel	Ainult sinu CID-d
Autentimine	Puudub	Valikuline token / IP-loend / päritolu-loend
SLA	Best-effort	Täielik SLA
Soovitatud	Juhuslikud lingid	Tootmis-manustamine (NFT, video, veebisaidid)
Kiirusepiirangud	Jagatud IP + CID kohta	Paketipõhine, seadistatav

Mõlemad teenindavad identset sisu. Tootmisliikluseks kasuta pühendatud väravat.

Milliseid failitüüpe toetatakse?

Kõiki failitüüpe toetatakse. JSON-objekte ja massiive saab saata otse. Kõik muud failid (pildid, PDF, HTML, video, heli, binaarfailid) saadetakse base64-kodeeritud sisuna.

Kas on faili suuruse piirang?

Üksikuid üleslaadimisi piirab teie plaani salvestuskvoot. Puudub eraldi faili suuruse piirang peale teie saadaoleva salvestusruumi.

Kas ma saan kinnitada sisu, mis on juba IPFS-is?

Jah. Kasutage POST /pin mis tahes kehtiva CID-ga. Meie klaster otsib sisu IPFS-võrgust ja kinnitab selle teie kontole. Vaadake Pinning API dokumentatsiooni üksikasjade saamiseks.

Kui kaua kinnitamine aega võtab?

See sõltub faili suurusest ja sellest, kui paljudel IPFS-sõlmedel on sisu. Väikesed, hästi jaotunud failid kinnituvad sekunditega. Suured või harva kinnitatud sisud võivad võtta mõne minuti. Kinnitamise lõpp-punkt tagastab kohe olekuga pinning — küsige GET /pin/:cid edenemise kontrollimiseks.

Mis juhtub, kui CID-d ei leita?

Olek muutub väärtusele failed. See tähendab, et CID on kas kehtetu või sisu pole enam kättesaadav ühelgi kättesaadaval IPFS-sõlmel.

Kas IPFS-i üleslaaditud andmed on avalikud?

Jah. Kogu IPFS-i kinnitatud sisu on avalikult kättesaadav selle CID kaudu mis tahes IPFS-gateway kaudu. Kui vajate privaatset juurdepääsu, kasutage pühendatud gatewayd tokeninõude režiimiga — see piirab juurdepääsu teie gateway kaudu, kuigi sisu jääb kättesaadavaks laiemas IPFS-võrgus.

Miks minu uued CID-d muutusid Qm... asemel bafy...-ks?

Uued üleslaadimised ja kinnitused tagastavad kaasaegse CIDv1 (bafk… väikese üheplokilise sisu jaoks, bafy… suuremate failide ja kataloogide jaoks) vastavalt IPIP-0499 unixfs-v1-2025 profiilile: CIDv1 base32 kodeering, 1 MiB tükid, toorlehed. See vastab sellele, mida kaasaegsed tööriistad (Helia, uusim Kubo, ipfs-car) sama sisu jaoks toodavad, nii et meie kaudu üles laaditud fail saab sama CID-i, mille iga kaasaegne klient samade baitide jaoks arvutaks.

Varasemate üleslaadimiste vanapärased Qm… CID-d jäävad täielikult lahendatavaks — gateway, POST /pin, GET /file, IPNS ja iga muu lõpp-punkt aktsepteerib mõlemat formaati määramatult kaua. Miski, mis teil juba on, ei lakka töötamast.

Kuidas kinnitada sisu, mis asub privaatsel / mitte-DHT sõlmel?

POST /pin aktsepteerib valikulist multiaddresses[] (kuni 5). Kui see on edastatud, teeb meie klaster ipfs swarm connect <multiaddr> iga vihje jaoks enne kinnitamise käivitumist, nii et sisu peer'idel, kes ei reklaami end avaliku DHT kaudu (privaatsed sõlmed, staging-keskkonnad, VPN-kohalikud masinad), on kättesaadav. Vaadake juhendit Kinnitamine privaatsest IPFS sõlmest.

Kas minu failid jäävad IPFS-i, kui tühistan oma konto?

Me eemaldame teie failide kinnituse meie sõlmedest, kui tühistate. Kui teised IPFS-sõlmed on teie sisu vahemällu salvestanud, võib see jääda kättesaadavaks. Kuid ilma aktiivse kinnitamiseta eemaldatakse failid lõpuks prügikoristuse käigus üle võrgu.

Autentimine & API

Kuidas autentida API-päringuid?

Edastage oma API-võti X-Api-Key päise kaudu. Genereerige võtmeid API-võtmed lehelt oma töölaual.

Kas on API-kiiruspiiranguid?

Ei. IPFS Ninja ei sea API-päringutele kiiruspiiranguid. Saate teha nii palju päringuid, kui vajate, igal plaanil.

Kas API-võtmed aeguvad?

Ei. API-võtmed kehtivad, kuni te need kustutate. Saate luua mitu võtit ja tühistada need ükshaaval.

Mis vahe on API-võtmetel ja gateway tokenitel?

API-võtmetel (bws_) on täielik juurdepääs — üles laadida, kustutada, loetleda faile. Gateway tokenid (gwt_) on ainult lugemiseks ja pääsevad failidele ligi ainult teie pühendatud gateway kaudu. Gateway tokeneid on turvaline kasutada frontend-rakendustes.

Pühendatud gatewayd

Mis on pühendatud gateway?

Privaatne IPFS-gateway teie oma alamdomeenile (nt abc123.gw.ipfs.ninja), mis teenindab ainult teie kontole kinnitatud faile. Erinevalt avalikust gatewayst ei lahenda see teiste kasutajate CID-sid.

Millised plaanid sisaldavad pühendatud gatewayd?

Pühendatud gatewayd on saadaval kõigil tasulistel plaanidel (Bodhi 5 $/kuu, Karma 19 $/kuu, Nirvana 59 $/kuu). Iga plaani igakuine ribalaiuse kvoot katab liiklust nii apex- kui pühendatud gatewaylt. Vaadake allpool "Kas on ribalaiuse tasusid?" plaanipõhiste kvootide jaoks.

Kas saan piirata, kes pääseb minu gatewayle?

Jah. Saate aktiveerida tokeninõude režiimi (nõuab gwt_-tokenit igal päringul) ja/või seadistada IP-lubade nimekirja (kuni 100 aadressi).

Kas saan piirata oma gatewayd päritolu/domeeni järgi?

Jah. Konfigureerige allowedOrigins oma gateway seadetes HTTPS päritoluaadresside nimekirjaga. Lubatakse ainult brauseripäringud nendelt päritoluaadressidelt. Mittebrauseripäringud (ilma Origin päiseta) pääsevad läbi. Tühi nimekiri lubab kõik päritoluaadressid.

Mis on allkirjastatud üleslaadimistokenid?

Allkirjastatud üleslaadimistokenid on ajaliselt piiratud volitused kliendipoolseteks üleslaadimisteks. Genereerite need oma serveris kasutades POST /upload/signed-url ja edastate need brauseritele või mobiilirakendustele. Klient autendib Authorization: Signed <token> asemel API-võtme paljastamist. Iga token jälgib kasutust ja aegub automaatselt. Vaadake allkirjastatud tokenite dokumentatsiooni üksikasjade saamiseks.

Kas saan optimeerida IPFS-ist serveeritud pilte?

Jah. Kasutage GET /image/:cid päringparameetritega nagu w, h, format ja quality, et muuta suurust, teisendada ja tihendada pilte lennult. Vastused salvestatakse vahemällu sisuadresseeritud CID põhjal. See töötab kõigil plaanidel. Vaadake Pildi optimeerimine.

Kas saan failidele metaandmeid lisada?

Jah. Lisage metadata objekt kuni 10 võtme-väärtus paariga, kui laadite üles POST /upload/new kaudu või kinnitate POST /pin kaudu. Metaandmed tagastatakse failide loendites ja faili detailide lõpp-punktis. Vaadake Failid ja Kinnitamine dokumentatsiooni.

Arveldus & Plaanid

Kas on tasuta plaan?

Jah. Dharma plaan on igavesti tasuta — 1 GB salvestusruumi, piiramatuid API-päringuid, krediitkaart pole vajalik.

Kas on ribalaiuse tasusid?

Mitte ühelgi plaanil pole mõõdetavaid ribalaiuse tasusid. Iga plaan sisaldab igakuist gateway ribalaiuse kvooti, mis on kõva piir — teie sisu lõpetab teenindamise nii apex- kui pühendatud gatewaylt, kui kvoot saab täis, ja jätkub järgmise kuu 1. kuupäeval või pärast uuendamist:

Plaan	Igakuine ribalaius
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Saate hoiatusmeile 80% ja 100% oma kvoodist.

Kas salvestusruum lähtestub?

Salvestusruum ei lähtestu. Teie plaan sisaldab kogu salvestuskvooti (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Ruumi vabastamiseks kustutage failid, mida te enam ei vaja. Plaani uuendamine suurendab teie kogu kvooti.

Kas saan igal ajal tühistada?

Jah. Tühistage oma tellimus arvelduportaali kaudu — sidumist pole. Teie konto naaseb tasuta tasemele ja olemasolevad kinnitatud failid jäävad kättesaadavaks.

Mis juhtub minu failidega, kui ma alanadan?

Teie failid jäävad IPFS-i kinnitatuks, kuid te ei saa rohkem üles laadida, kui teie praegune kasutus ületab uue plaani salvestuspiiri. Kustutage failid, et piiri alla jõuda.

Turvalisus

Kas mu andmed on krüpteeritud?

Kõik andmed on krüpteeritud edastamisel TLS/HTTPS kaudu. Autentimine kasutab JWT-tokeneid (Cognito) ja turvaliselt salvestatud API-võtmeid. Failisisu IPFS-is pole puhkeolekus krüpteeritud — IPFS on disainilt avalik võrk.

Kas on turvaline kasutada API-võtmeid minu serveri koodis?

Jah. API-võtmed on mõeldud serveripoolseks kasutamiseks. Ärge kunagi paljastage neid kliendipoolses koodis. Kliendipoolse failide juurdepääsu jaoks kasutage gateway tokeneid (gwt_), mis on ainult lugemiseks.

Tugi

Kuidas saan abi?

Saatke e-kiri aadressile info@ipfs.ninja või vaadake API viidet.

Kas on SLA?

Püüdleme kõrge kättesaadavuse poole, kuid ei paku hetkel ametlikku SLA-d. Teenust pakutakse "nagu on" põhimõttel.