UKK

Usein kysytyt kysymykset IPFS Ninjasta.

Yleistä

Mikä on IPFS Ninja?

IPFS Ninja on hallittu IPFS-kiinnityspalvelu. Lataat minkä tahansa tiedoston yksinkertaisen REST API:n kautta tai kiinnität olemassa olevia CID:itä IPFS-verkosta. Jokainen tiedosto saa pysyvän sisältötunnisteen (CID) ja on saatavilla gatewaymme kautta osoitteessa ipfs.ninja/ipfs/<CID>.

Mitä tiedostotyyppejä tuetaan?

Kaikkia tiedostotyyppejä tuetaan. JSON-objektit ja taulukot voidaan lähettää suoraan. Kaikki muut tiedostot (kuvat, PDF, HTML, video, ääni, binäärit) lähetetään base64-koodattuna sisältönä.

Onko tiedostokokorajoitusta?

Yksittäisiä latauksia rajoittaa suunnitelmasi tallennuskiintiö. Yksittäiselle tiedostolle ei ole kokorajoitusta käytettävissä olevan tallennustilan lisäksi.

Voinko kiinnittää sisältöä, joka on jo IPFS:ssä?

Kyllä. Käytä POST /pin millä tahansa kelvollisella CID:llä. Klusterimme hakee sisällön IPFS-verkosta ja kiinnittää sen tilillesi. Katso Pinning API -dokumentaatio lisätiedoille.

Kuinka kauan kiinnitys kestää?

Se riippuu tiedostokoosta ja siitä, kuinka monella IPFS-solmulla on sisältö. Pienet, hyvin jaellut tiedostot kiinnittyvät sekunneissa. Suuret tai harvoin kiinnitetyt sisällöt voivat viedä muutaman minuutin. Kiinnityksen päätepiste palauttaa välittömästi tilalla pinning — kysy GET /pin/:cid tarkistaaksesi edistymisen.

Mitä tapahtuu, jos CID:tä ei löydy?

Tila muuttuu tilaan failed. Tämä tarkoittaa, että CID on joko virheellinen tai sisältö ei ole enää saatavilla millään tavoitettavissa olevalla IPFS-solmulla.

Onko IPFS:ään ladattu data julkista?

Kyllä. Kaikki IPFS:ään kiinnitetty sisältö on julkisesti saatavilla sen CID:n kautta minkä tahansa IPFS-gatewayn kautta. Jos tarvitset yksityistä pääsyä, käytä dedikoitua gatewayta token-vaatimustilassa — tämä rajoittaa pääsyä gatewayysi kautta, vaikka sisältö pysyy saatavilla laajemmassa IPFS-verkossa.

Pysyvätkö tiedostoni IPFS:ssä, jos peruutan tilini?

Poistamme tiedostojesi kiinnityksen solmuiltamme, kun peruutat. Jos muut IPFS-solmut ovat välimuistineet sisältösi, se voi pysyä saatavilla. Mutta ilman aktiivista kiinnitystä tiedostot poistetaan lopulta roskienkeruussa verkossa.

Todennus & API

Miten todentaa API-pyynnöt?

Lähetä API-avaimesi X-Api-Key-otsakkeen kautta. Generoi avaimia API-avaimet -sivulta kojelaudallasi.

Onko API-nopeusrajoituksia?

Ei. IPFS Ninja ei aseta nopeusrajoituksia API-pyynnöille. Voit tehdä niin monta pyyntöä kuin tarvitset millä tahansa suunnitelmalla.

Vanhenevatko API-avaimet?

Eivät. API-avaimet ovat voimassa, kunnes poistat ne. Voit luoda useita avaimia ja peruuttaa ne yksitellen.

Mikä on ero API-avainten ja gateway-tokenien välillä?

API-avaimilla (bws_) on täysi pääsy — lataa, poista, listaa tiedostoja. Gateway-tokenit (gwt_) ovat vain luku -käyttöön ja voivat käyttää tiedostoja vain dedikoidun gatewaysi kautta. Gateway-tokenit ovat turvallisia upotettaviksi frontend-sovelluksiin.

Dedikoidut gatewayt

Mikä on dedikoitu gateway?

Yksityinen IPFS-gateway omalla aliverkkotunnuksellasi (esim. abc123.gw.ipfs.ninja), joka palvelee vain tilillesi kiinnitettyjä tiedostoja. Toisin kuin julkinen gateway, se ei ratkaise muiden käyttäjien CID:itä.

Mitkä suunnitelmat sisältävät dedikoidun gatewayn?

Dedikoidut gatewayt ovat saatavilla Nirvana-suunnitelmassa (29 $/kk), joka sisältää 50 GB/kk gateway-kaistanleveyttä.

Voinko rajoittaa, kuka pääsee gatewaylleni?

Kyllä. Voit ottaa käyttöön token-vaatimustilan (vaatii gwt_-tokenin jokaiseen pyyntöön) ja/tai asettaa IP-sallittujen listan (enintään 100 osoitetta).

Voinko rajoittaa gatewaytani alkuperän/verkkotunnuksen mukaan?

Kyllä. Määritä allowedOrigins gateway-asetuksissasi HTTPS-alkuperien listalla. Vain selainpyynnöt näistä alkuperistä sallitaan. Muut kuin selainpyynnöt (ilman Origin-otsaketta) pääsevät läpi. Tyhjä lista sallii kaikki alkuperät.

Mitä ovat allekirjoitetut lataustokenit?

Allekirjoitetut lataustokenit ovat aikamääräisiä tunnistetietoja asiakaspuolen latauksiin. Generoit ne palvelimellasi käyttäen POST /upload/signed-url ja välität ne selaimille tai mobiilisovelluksille. Asiakas todentaa Authorization: Signed <token> -otsakkeella API-avaimen paljastamisen sijaan. Jokainen token seuraa käyttöä ja vanhenee automaattisesti. Katso allekirjoitettujen tokenien dokumentaatio lisätiedoille.

Voinko optimoida IPFS:stä palveltuja kuvia?

Kyllä. Käytä GET /image/:cid kyselyparametreilla kuten w, h, format ja quality muuttaaksesi kokoa, muuntaaksesi ja pakataksesi kuvia lennossa. Vastaukset välimuistitetaan sisältöosoitteistetun CID:n perusteella. Tämä toimii kaikilla suunnitelmilla. Katso Kuvan optimointi.

Voinko liittää metatietoja tiedostoihin?

Kyllä. Sisällytä metadata-objekti enintään 10 avain-arvo-parilla ladatessasi POST /upload/new kautta tai kiinnittäessäsi POST /pin kautta. Metatiedot palautetaan tiedostolistauksissa ja tiedoston yksityiskohtien päätepisteessä. Katso Tiedostot ja Kiinnitys -dokumentaatio.

Laskutus & Suunnitelmat

Onko ilmainen suunnitelma?

Kyllä. Dharma-suunnitelma on ilmainen ikuisesti — 1 GB tallennustilaa, rajattomat API-pyynnöt, luottokorttia ei vaadita.

Onko kaistanleveysmaksuja?

Ei kaistanleveysmaksuja API-pyynnöille millään suunnitelmalla. Dedikoitu gateway-kaistanleveys (Nirvana-suunnitelma) sisältää 50 GB/kk. Kun raja saavutetaan, gateway-pyynnöt estetään seuraavaan kuukauteen asti.

Nollautuuko tallennustila?

Tallennustila ei nollaudu. Suunnitelmasi sisältää kokonaistallennuskiintiön (1 GB / 10 GB / 100 GB). Vapauttaaksesi tilaa, poista tiedostoja, joita et enää tarvitse. Suunnitelman päivittäminen kasvattaa kokonaiskiintiötäsi.

Voinko peruuttaa milloin tahansa?

Kyllä. Peruuta tilauksesi laskutusportaalin kautta — ei sidontaa. Tilisi palautuu ilmaiselle tasolle, ja olemassa olevat kiinnitetyt tiedostot pysyvät saatavilla.

Mitä tiedostoilleni tapahtuu, jos alennan suunnitelmaani?

Tiedostosi pysyvät kiinnitettyinä IPFS:ään, mutta et voi ladata lisää, jos nykyinen käyttösi ylittää uuden suunnitelman tallennusrajan. Poista tiedostoja päästäksesi rajan alle.

Turvallisuus

Onko datani salattu?

Kaikki data on salattu siirron aikana TLS/HTTPS:n kautta. Todennus käyttää JWT-tokeneita (Cognito) ja turvallisesti tallennettuja API-avaimia. Tiedostosisältö IPFS:ssä ei ole salattu levossa — IPFS on suunniteltu julkiseksi verkoksi.

Onko turvallista käyttää API-avaimia palvelinkoodissani?

Kyllä. API-avaimet on suunniteltu palvelinpuolen käyttöön. Älä koskaan paljasta niitä asiakaspuolen koodissa. Asiakaspuolen tiedostojen käyttöön käytä gateway-tokeneita (gwt_), jotka ovat vain luku -käyttöön.

Tuki

Miten saan apua?

Lähetä sähköpostia osoitteeseen info@ipfs.ninja tai tarkista API-viite.

Onko SLA:ta?

Pyrimme korkeaan saatavuuteen, mutta emme tarjoa tällä hetkellä muodollista SLA:ta. Palvelu tarjotaan "sellaisenaan" -periaatteella.