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 inhoudsidentificatie (CID) en is toegankelijk via onze gateway op ipfs.ninja/ipfs/<CID>.

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

Is er een bestandsgroottelimiet?

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

Kan ik inhoud vastzetten die al op IPFS bestaat?

Ja. Gebruik POST /pin met een geldige CID. Ons cluster haalt de inhoud 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-knooppunten de inhoud hebben. Kleine, goed gedistribueerde bestanden worden in seconden vastgezet. Grote of zelden vastgezette inhoud kan enkele minuten duren. Het vastzetendpoint 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 inhoud niet meer beschikbaar is op een bereikbaar IPFS-knooppunt.

Zijn gegevens die naar IPFS worden ge\u00fcpload openbaar?

Ja. Alle inhoud die op IPFS is vastgezet, is openbaar toegankelijk via de CID via elke IPFS-gateway. Als je prive-toegang nodig hebt, gebruik dan een dedicated gateway met tokenvereistemode.

Blijven mijn bestanden op IPFS als ik mijn account annuleer?

We maken de vastzetactie van je bestanden ongedaan op onze knooppunten wanneer je annuleert. Als andere IPFS-knooppunten je inhoud in de cache hebben, kan deze nog steeds toegankelijk zijn. Zonder actieve vastzetting worden bestanden uiteindelijk verwijderd door garbage collection.

Authenticatie & API

Hoe authenticeer ik API-verzoeken?

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

Zijn er API-snelheidslimieten?

Nee. IPFS Ninja legt geen snelheidslimieten 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 weergeven. Gateway-tokens (gwt_) zijn alleen-lezen en kunnen alleen bestanden openen via je dedicated gateway. Gateway-tokens zijn veilig om in te sluiten in frontend-apps.

Dedicated gateways

Wat is een dedicated gateway?

Een prive IPFS-gateway op je eigen subdomein (bijv. abc123.gw.ipfs.ninja) die alleen bestanden serveert die aan je account zijn vastgezet.

Welke plannen bevatten een dedicated gateway?

Dedicated gateways zijn beschikbaar met het Nirvana-plan ($29/maand), inclusief 50 GB/maand gateway-bandbreedte.

Kan ik beperken wie toegang heeft tot mijn gateway?

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

Kan ik mijn gateway beperken op oorsprong/domein?

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

Wat zijn ondertekende upload-tokens?

Ondertekende upload-tokens zijn tijdgelimiteerde referenties 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. Zie de documentatie voor ondertekende tokens.

Kan ik afbeeldingen optimaliseren die vanuit IPFS worden aangeboden?

Ja. Gebruik GET /image/:cid met queryparameters zoals w, h, format en quality om afbeeldingen direct te verkleinen, converteren en comprimeren. Zie Beeldoptimalisatie.

Kan ik metadata aan bestanden koppelen?

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

Facturering & plannen

Is er een gratis plan?

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

Zijn er bandbreedtekosten?

Geen bandbreedtekosten voor API-verzoeken op elk plan. Dedicated gateway-bandbreedte (Nirvana-plan) bevat 50 GB/maand. Bij het bereiken van de limiet worden gateway-verzoeken geblokkeerd tot de volgende maand.

Wordt de opslag gereset?

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

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 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. Bestandsinhoud op IPFS is niet versleuteld in rust -- IPFS is van nature een openbaar netwerk.

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

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

Ondersteuning

Hoe krijg ik hulp?

E-mail info@ipfs.ninja of bekijk de API-referentie-documentatie.

Is er een SLA?

We streven naar hoge beschikbaarheid maar bieden momenteel geen formeel SLA aan. De dienst wordt aangeboden in de huidige staat.