FAQ

Često postavljana pitanja o IPFS Ninja.

Općenito

Što je IPFS Ninja?

IPFS Ninja je upravljana IPFS usluga prikvačivanja. Prenosite bilo koju datoteku putem jednostavnog REST API-ja ili prikvačujete postojeće CID-ove s IPFS mreže. Svaka datoteka dobiva trajni identifikator sadržaja (CID) i dostupna je putem našeg gatewaya na ipfs.ninja/ipfs/<CID>.

Koji tipovi datoteka su podržani?

Svi tipovi datoteka su podržani. JSON objekti i polja mogu se slati izravno. Sve ostale datoteke (slike, PDF-ovi, HTML, video, audio, binarne datoteke) šalju se kao base64-kodirani sadržaj.

Postoji li ograničenje veličine datoteke?

Pojedinačni prijenosi ograničeni su pohranom vašeg plana. Nema ograničenja veličine po datoteci izvan vaše dostupne pohrane.

Mogu li prikvačiti sadržaj koji već postoji na IPFS-u?

Da. Koristite POST /pin s bilo kojim valjanim CID-om. Naš klaster će dohvatiti sadržaj s IPFS mreže i prikvačiti ga na vaš račun. Pogledajte dokumentaciju Pinning API-ja za detalje.

Koliko dugo traje prikvačivanje?

Ovisi o veličini datoteke i koliko IPFS čvorova ima sadržaj. Male, dobro distribuirane datoteke prikvače se u sekundama. Veliki ili rijetko prikvačeni sadržaj može trajati nekoliko minuta. Endpoint za prikvačivanje odmah vraća status pinning — provjeravajte GET /pin/:cid za praćenje napretka.

Što se dogodi ako se CID ne može pronaći?

Status se mijenja u failed. To znači da je CID ili nevažeći ili da sadržaj više nije dostupan na nijednom dostupnom IPFS čvoru.

Jesu li podaci preneseni na IPFS javni?

Da. Sav sadržaj prikvačen na IPFS javno je dostupan putem svog CID-a kroz bilo koji IPFS gateway. Ako trebate privatni pristup, koristite namjenski gateway s načinom rada koji zahtijeva token — to ograničava pristup putem vašeg gatewaya, iako sadržaj ostaje dostupan na široj IPFS mreži.

Hoće li moje datoteke ostati na IPFS-u ako otkazam račun?

Prilikom otkazivanja otkvačujemo vaše datoteke s naših čvorova. Ako drugi IPFS čvorovi imaju vaš sadržaj u predmemoriji, može ostati dostupan. Međutim, bez aktivnog prikvačivanja, datoteke će s vremenom biti uklonjene sakupljanjem smeća na cijeloj mreži.

Autentifikacija i API

Kako autentificiram API zahtjeve?

Proslijedite svoj API ključ putem zaglavlja X-Api-Key. Ključeve generirajte sa stranice API ključevi u vašoj nadzornoj ploči.

Postoje li ograničenja brzine API-ja?

Ne. IPFS Ninja ne nameće ograničenja brzine na API zahtjeve. Možete slati koliko god zahtjeva trebate na bilo kojem planu.

Istječu li API ključevi?

Ne. API ključevi vrijede dok ih ne izbrišete. Možete kreirati više ključeva i pojedinačno ih opozvati.

Koja je razlika između API ključeva i tokena gatewaya?

API ključevi (bws_) imaju puni pristup — prijenos, brisanje, popis datoteka. Tokeni gatewaya (gwt_) su samo za čitanje i mogu pristupiti datotekama samo putem vašeg namjenskog gatewaya. Tokene gatewaya sigurno je ugraditi u frontend aplikacije.

Namjenski gatewayevi

Što je namjenski gateway?

Privatni IPFS gateway na vašoj vlastitoj poddomeni (npr. abc123.gw.ipfs.ninja) koji služi samo datoteke prikvačene na vaš račun. Za razliku od javnog gatewaya, neće razrješavati CID-ove drugih korisnika.

Koji planovi uključuju namjenski gateway?

Namjenski gatewayevi dostupni su na Nirvana planu (29 $/mj.), koji uključuje 50 GB/mjesečno propusnosti gatewaya.

Mogu li ograničiti tko pristupa mom gatewayu?

Da. Možete omogućiti način rada koji zahtijeva token (zahtijeva gwt_ token pri svakom zahtjevu) i/ili postaviti popis dopuštenih IP adresa (do 100 adresa).

Mogu li ograničiti svoj gateway prema izvoru/domeni?

Da. Konfigurirajte allowedOrigins u vašim postavkama gatewaya s popisom HTTPS izvora. Samo zahtjevi iz preglednika s tih izvora bit će dopušteni. Zahtjevi izvan preglednika (bez zaglavlja Origin) prolaze bez ograničenja. Prazan popis dopušta sve izvore.

Što su potpisani tokeni za prijenos?

Potpisani tokeni za prijenos su vremenski ograničene vjerodajnice za prijenos na strani klijenta. Generirate ih na svom poslužitelju koristeći POST /upload/signed-url i prosljeđujete ih preglednicima ili mobilnim aplikacijama. Klijent se autentificira s Authorization: Signed <token> umjesto otkrivanja vašeg API ključa. Svaki token prati korištenje i automatski istječe. Pogledajte dokumentaciju Potpisanih tokena za detalje.

Mogu li optimizirati slike posluživane s IPFS-a?

Da. Koristite GET /image/:cid s parametrima upita poput w, h, format i quality za promjenu veličine, pretvorbu i kompresiju slika u hodu. Odgovori se spremaju u predmemoriju na temelju CID-a adresiranog sadržajem. Radi na svim planovima. Pogledajte Optimizacija slika.

Mogu li priložiti metapodatke datotekama?

Da. Uključite objekt metadata s do 10 parova ključ-vrijednost prilikom prijenosa putem POST /upload/new ili prikvačivanja putem POST /pin. Metapodaci se vraćaju u popisima datoteka i na endpointu detalja datoteke. Pogledajte dokumentaciju Datoteke i Prikvačivanje.

Naplata i planovi

Postoji li besplatni plan?

Da. Plan Dharma besplatan je zauvijek — 1 GB pohrane, neograničeni API zahtjevi, bez potrebe za kreditnom karticom.

Postoje li naknade za propusnost?

Nema naknada za propusnost na API zahtjevima za bilo koji plan. Propusnost namjenskog gatewaya (Nirvana plan) uključuje 50 GB/mjesečno. Kada se dosegne ograničenje, zahtjevi na gateway blokiraju se do sljedećeg mjeseca.

Resetira li se pohrana?

Pohrana se ne resetira. Vaš plan uključuje ukupni limit pohrane (1 GB / 10 GB / 100 GB). Za oslobađanje prostora izbrišite datoteke koje više ne trebate. Nadogradnja plana povećava vaš ukupni limit.

Mogu li otkazati bilo kad?

Da. Otkažite pretplatu putem portala za naplatu — bez obveza. Vaš račun vraća se na besplatnu razinu, a postojeće prikvačene datoteke ostaju dostupne.

Što se dogodi s mojim datotekama ako snizim plan?

Vaše datoteke ostaju prikvačene na IPFS-u, ali ne možete prenositi više ako vaše trenutno korištenje premašuje limit pohrane novog plana. Izbrišite datoteke da biste se vratili ispod ograničenja.

Sigurnost

Jesu li moji podaci kriptirani?

Svi podaci kriptirani su u prijenosu putem TLS/HTTPS. Autentifikacija koristi JWT tokene (Cognito) i sigurno pohranjene API ključeve. Sadržaj datoteka na IPFS-u nije kriptiran u mirovanju — IPFS je po dizajnu javna mreža.

Je li sigurno koristiti API ključeve u mom poslužiteljskom kodu?

Da. API ključevi dizajnirani su za korištenje na strani poslužitelja. Nikada ih ne izlažite u kodu na strani klijenta. Za pristup datotekama na strani klijenta koristite tokene gatewaya (gwt_) koji su samo za čitanje.

Podrška

Kako mogu dobiti pomoć?

Pošaljite e-poštu na info@ipfs.ninja ili pogledajte dokumentaciju Referenca API-ja.

Postoji li SLA?

Težimo visokoj dostupnosti, ali trenutno ne nudimo formalni SLA. Usluga se pruža na osnovi „kakva jest".