FAQ

Veelgestelde vragen over IPFS Ninja.

Algemeen

Wat is IPFS Ninja?

IPFS Ninja is een beheerde IPFS-vastzetservice. Je uploadt elk bestand via een eenvoudige REST API, of zet bestaande CID's vast vanuit het IPFS-netwerk. Elk bestand krijgt een permanente content-identifier (CID) en is toegankelijk via onze gateway op ipfs.ninja/ipfs/<CID>.

Bedient ipfs.ninja/ipfs/<CID> elke CID op het IPFS-netwerk?

Nee. De apex-gateway bedient alleen CID's die zijn geüpload of vastgezet door een IPFS Ninja-gebruiker. Verzoeken voor onbekende CID's geven HTTP 410 Gone terug met een verwijzing naar publieke IPFS-gateways (ipfs.io, dweb.link). Om een CID van een derde partij via onze gateway te serveren, doe je eerst POST /pin op je account — eenmaal vastgezet is de CID toegankelijk via zowel de apex- als je dedicated-gateway-URL.

Wat is het verschil tussen de apex-gateway en de dedicated gateway?

Aspect	Apex ipfs.ninja/ipfs/<CID>	Dedicated <slug>.gw.ipfs.ninja/ipfs/<CID>
Bereik	Gedeeld tussen alle gebruikers	Alleen je eigen CID's
Authenticatie	Geen	Optionele token / IP-allowlist / origin-allowlist
SLA	Best-effort	Volledige SLA
Aanbevolen voor	Losse links	Productie-embedding (NFT, video, websites)
Ratelimieten	Gedeeld per IP + per CID	Per plan, configureerbaar

Beide leveren identieke content. Gebruik voor productieverkeer de dedicated gateway.

Welke bestandstypen worden ondersteund?

Alle bestandstypen worden ondersteund. JSON-objecten en -arrays kunnen direct worden verzonden. Alle andere bestanden (afbeeldingen, PDF's, HTML, video, audio, binaire bestanden) worden verzonden als base64-gecodeerde content.

Is er een bestandsgroottelimiet?

Individuele uploads worden beperkt door de opslagruimte van je plan. Er is geen limiet per bestand buiten je beschikbare opslag.

Kan ik content vastzetten die al op IPFS bestaat?

Ja. Gebruik POST /pin met elke geldige CID. Ons cluster haalt de content op van het IPFS-netwerk en zet deze vast op je account. Zie de Pinning API-documentatie voor details.

Hoe lang duurt vastzetten?

Dit hangt af van de bestandsgrootte en hoeveel IPFS-nodes de content hebben. Kleine, goed gedistribueerde bestanden worden in seconden vastgezet. Grote of zelden vastgezette content kan enkele minuten duren. Het pin-endpoint retourneert onmiddellijk met status pinning — poll GET /pin/:cid om de voortgang te controleren.

Wat gebeurt er als een CID niet kan worden gevonden?

De status verandert naar failed. Dit betekent dat de CID ongeldig is of dat de content niet meer beschikbaar is op een bereikbare IPFS-node.

Is data die naar IPFS wordt geüpload openbaar?

Ja. Alle content die op IPFS is vastgezet, is publiek toegankelijk via zijn CID via elke IPFS-gateway. Als je privétoegang nodig hebt, gebruik dan een dedicated gateway met tokenvereiste modus — dit beperkt de toegang via je gateway, hoewel de content beschikbaar blijft op het bredere IPFS-netwerk.

Waarom zijn mijn nieuwe CID's veranderd van Qm... naar bafy...?

Nieuwe uploads en pins retourneren moderne CIDv1 (bafk… voor kleine content in één blok, bafy… voor grotere bestanden en directory's) volgens het IPIP-0499 unixfs-v1-2025-profiel: CIDv1 base32-codering, 1 MiB-chunks, raw leaves. Dit komt overeen met wat moderne tooling (Helia, de nieuwste Kubo, ipfs-car) produceert voor dezelfde content, dus een bestand dat via ons wordt geüpload krijgt dezelfde CID die elke moderne client zou berekenen voor dezelfde bytes.

Legacy Qm…-CID's van eerdere uploads blijven volledig oplosbaar — de gateway, POST /pin, GET /file, IPNS, en elk ander endpoint accepteert beide formaten voor onbepaalde tijd. Niets wat je al hebt, stopt met werken.

Hoe pin ik content die op een private/non-DHT-node staat?

POST /pin accepteert optionele multiaddresses[] (tot 5). Indien opgegeven, voert ons cluster ipfs swarm connect <multiaddr> uit voor elke hint vóór het vastzetten, zodat content op peers die niet via de publieke DHT adverteren (private nodes, staging-omgevingen, VPN-lokale machines) bereikbaar is. Zie de gids Pin from a private IPFS node.

Blijven mijn bestanden op IPFS staan als ik mijn account annuleer?

We ontkoppelen je bestanden van onze nodes wanneer je annuleert. Als andere IPFS-nodes je content in de cache hebben, kan deze nog steeds toegankelijk zijn. Zonder actieve vastzetting worden bestanden echter uiteindelijk verwijderd door garbage collection over het hele netwerk.

Authenticatie & API

Hoe authenticeer ik API-verzoeken?

Geef je API-sleutel door via de X-Api-Key-header. Genereer sleutels vanaf de pagina API Keys in je dashboard.

Zijn er API-ratelimieten?

Nee. IPFS Ninja legt geen ratelimieten op voor API-verzoeken. Je kunt zoveel verzoeken doen als nodig, op elk plan.

Verlopen API-sleutels?

Nee. API-sleutels zijn geldig totdat je ze verwijdert. Je kunt meerdere sleutels aanmaken en ze afzonderlijk intrekken.

Wat is het verschil tussen API-sleutels en gateway-tokens?

API-sleutels (bws_) hebben volledige toegang — uploaden, verwijderen, bestanden oplijsten. Gateway-tokens (gwt_) zijn alleen-lezen en kunnen alleen bestanden benaderen via je dedicated gateway. Gateway-tokens zijn veilig om in te bedden in frontend-apps.

Dedicated gateways

Wat is een dedicated gateway?

Een private IPFS-gateway op je eigen subdomein (bijv. abc123.gw.ipfs.ninja) die alleen bestanden serveert die aan je account zijn vastgezet. In tegenstelling tot de publieke gateway lost deze geen CID's van andere gebruikers op.

Welke plannen bevatten een dedicated gateway?

Dedicated gateways zijn beschikbaar op alle betaalde plannen (Bodhi $5/maand, Karma $19/maand, Nirvana $59/maand). Het maandelijkse bandbreedtequotum van elk plan dekt verkeer van zowel de apex- als de dedicated gateway. Zie "Zijn er bandbreedtekosten?" hieronder voor de quota per plan.

Kan ik beperken wie toegang heeft tot mijn gateway?

Ja. Je kunt de tokenvereiste modus inschakelen (vereist een gwt_-token bij elk verzoek) en/of een IP-whitelist instellen (tot 100 adressen).

Kan ik mijn gateway beperken op origin/domein?

Ja. Configureer allowedOrigins in je gateway-instellingen met een lijst van HTTPS-origins. Alleen browserverzoeken vanaf die origins worden toegestaan. Niet-browserverzoeken (zonder een Origin-header) gaan door. Een lege lijst staat alle origins toe.

Wat zijn ondertekende upload-tokens?

Ondertekende upload-tokens zijn tijdgelimiteerde credentials voor client-side uploads. Je genereert ze op je server met POST /upload/signed-url en geeft ze door aan browsers of mobiele apps. De client authenticeert met Authorization: Signed <token> in plaats van je API-sleutel bloot te stellen. Elk token houdt gebruik bij en verloopt automatisch. Zie de documentatie over ondertekende tokens voor details.

Kan ik afbeeldingen optimaliseren die vanaf IPFS worden geserveerd?

Ja. Gebruik GET /image/:cid met queryparameters zoals w, h, format en quality om afbeeldingen direct te verkleinen, converteren en comprimeren. Responsen worden gecachet op basis van de content-geadresseerde CID. Dit werkt op alle plannen. Zie Beeldoptimalisatie.

Kan ik metadata aan bestanden koppelen?

Ja. Voeg een metadata-object toe met tot 10 sleutel-waardeparen bij het uploaden via POST /upload/new of vastzetten via POST /pin. Metadata wordt geretourneerd in bestandsoverzichten en het bestandsdetail-endpoint. Zie de documentatie voor Bestanden en Vastzetten.

Facturering & plannen

Is er een gratis plan?

Ja. Het Dharma-plan is voor altijd gratis — 1 GB opslag, onbeperkte API-verzoeken, geen creditcard vereist.

Zijn er bandbreedtekosten?

Geen gemeten bandbreedtekosten op enig plan. Elk plan bevat een maandelijks gateway-bandbreedtequotum dat een harde limiet is — je content stopt met serveren op de apex- en dedicated gateways zodra het quotum is bereikt, en hervat op de 1e van de volgende maand of na een upgrade:

Plan	Maandelijkse bandbreedte
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Je ontvangt waarschuwingsmails bij 80% en 100% van je quotum.

Wordt de opslag gereset?

Opslag wordt niet gereset. Je plan bevat een totale opslagruimte (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Om ruimte vrij te maken, verwijder je bestanden die je niet meer nodig hebt. Upgraden van je plan verhoogt je totale opslagruimte.

Kan ik op elk moment opzeggen?

Ja. Zeg je abonnement op via het factureringsportaal — geen verplichtingen. Je account keert terug naar het gratis niveau en bestaande vastgezette bestanden blijven toegankelijk.

Wat gebeurt er met mijn bestanden als ik downgrade?

Je bestanden blijven vastgezet op IPFS, maar je kunt niet meer uploaden als je huidige gebruik de opslaglimiet van het nieuwe plan overschrijdt. Verwijder bestanden om weer onder de limiet te komen.

Beveiliging

Zijn mijn gegevens versleuteld?

Alle gegevens zijn versleuteld tijdens transport via TLS/HTTPS. Authenticatie gebruikt JWT-tokens (Cognito) en veilig opgeslagen API-sleutels. Bestandscontent op IPFS is niet versleuteld in rust — IPFS is naar ontwerp een publiek netwerk.

Is het veilig om API-sleutels in mijn servercode te gebruiken?

Ja. API-sleutels zijn ontworpen voor gebruik aan de serverzijde. Stel ze nooit bloot in client-side code. Gebruik voor client-side bestandstoegang gateway-tokens (gwt_), die alleen-lezen zijn.

Ondersteuning

Hoe krijg ik hulp?

Mail naar info@ipfs.ninja of bekijk de documentatie in de API-referentie.

Is er een SLA?

We streven naar hoge beschikbaarheid, maar bieden op dit moment geen formele SLA aan. De service wordt geleverd op een "as is"-basis.