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

Poslužuje li ipfs.ninja/ipfs/<CID> bilo koji CID na IPFS mreži?

Ne. Apex pristupnik poslužuje samo CID-ove koje je prenio ili prikvačio korisnik IPFS Ninja. Zahtjevi za nepoznate CID-ove vraćaju HTTP 410 Gone s pokazivačem na javne IPFS pristupnike (ipfs.io, dweb.link). Da biste posluživali CID treće strane putem našeg pristupnika, prvo izvršite POST /pin na svoj račun — nakon prikvačivanja CID postaje dostupan i na apex i na URL-u vašeg namjenskog pristupnika.

Koja je razlika između apex pristupnika i namjenskog pristupnika?

Aspekt	Apex ipfs.ninja/ipfs/<CID>	Namjenski <slug>.gw.ipfs.ninja/ipfs/<CID>
Opseg	Dijeljen među svim korisnicima	Samo vaši CID-ovi
Autentifikacija	Nema	Opcionalni token / IP allowlist / origin allowlist
SLA	Best-effort	Puni SLA
Preporučuje se za	Povremene poveznice	Produkcijska ugradnja (NFT, video, web stranice)
Ograničenja brzine	Dijeljena po IP-u + po CID-u	Prema planu, prilagodljivo

Oba poslužuju identičan sadržaj. Za produkcijski promet koristite namjenski pristupnik.

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.

Zašto su se moji novi CID-ovi promijenili s Qm... na bafy...?

Novi prijenosi i prikvačivanja vraćaju moderni CIDv1 (bafk… za mali sadržaj u jednom bloku, bafy… za veće datoteke i direktorije) prema profilu IPIP-0499 unixfs-v1-2025: CIDv1 base32 kodiranje, dijelovi od 1 MiB, raw leaves. Ovo odgovara onome što moderni alati (Helia, najnoviji Kubo, ipfs-car) proizvode za isti sadržaj, tako da datoteka prenesena putem nas dobiva isti CID koji bi bilo koji moderni klijent izračunao za iste bajtove.

Stari Qm… CID-ovi iz ranijih prijenosa ostaju u potpunosti razrješivi — gateway, POST /pin, GET /file, IPNS i svaki drugi endpoint prihvaćaju oba formata bez vremenskog ograničenja. Ništa što već imate neće prestati raditi.

Kako prikvačiti sadržaj koji se nalazi na privatnom / ne-DHT čvoru?

POST /pin prihvaća opcionalni multiaddresses[] (do 5). Ako je naveden, naš klaster izvršava ipfs swarm connect <multiaddr> za svaku naznaku prije pokretanja prikvačivanja, tako da sadržaj na peerovima koji se ne oglašavaju putem javnog DHT-a (privatni čvorovi, staging okruženja, VPN-lokalni strojevi) postaje dostupan. Pogledajte vodič Prikvačivanje s privatnog IPFS čvora.

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 svim plaćenim planovima (Bodhi 5 $/mj., Karma 19 $/mj., Nirvana 59 $/mj.). Mjesečna kvota propusnosti svakog plana pokriva promet i s apex i s namjenskog gatewaya. Pogledajte „Postoje li naknade za propusnost?" niže za kvote po planu.

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 mjerenih naknada za propusnost ni na jednom planu. Svaki plan uključuje mjesečnu kvotu propusnosti gatewaya koja predstavlja tvrdo ograničenje — vaš sadržaj prestaje se posluživati na apex i namjenskom gatewayu čim se kvota dosegne, a poslužuje se ponovno 1. u sljedećem mjesecu ili nakon nadogradnje:

Plan	Mjesečna propusnost
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Primit ćete upozoravajuće e-poruke na 80% i 100% vaše kvote.

Resetira li se pohrana?

Pohrana se ne resetira. Vaš plan uključuje ukupnu dozvoljenu pohranu (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). 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".