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

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.

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 Nirvana plaanis (29 $/kuu), mis sisaldab 50 GB/kuu gateway ribalaiust.

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?

Ribalaiuse tasud API-päringutele puuduvad igal plaanil. Pühendatud gateway ribalaius (Nirvana plaan) sisaldab 50 GB/kuus. Piiri saavutamisel blokeeritakse gateway päringud kuni järgmise kuuni.

Kas salvestusruum lähtestub?

Salvestusruum ei lähtestu. Teie plaan sisaldab kogu salvestuskvooti (1 GB / 10 GB / 100 GB). 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.