IPFS Ninja

Upload eenvoudig afbeeldingen, PDF's en JSON-bestanden naar IPFS en ontvang een permanente content-identifier (CID) met directe gateway-toegang.

Wat is IPFS?

Het InterPlanetary File System (IPFS) is een gedecentraliseerd, peer-to-peer opslagprotocol. IPFS breekt bestanden op in kleinere stukken, distribueert ze over het netwerk en wijst elk bestand een unieke content-identifier (CID) toe op basis van de inhoud.

Dit betekent:

• Gedistribueerde opslag — je bestanden worden opgeslagen op meerdere nodes voor verbeterde betrouwbaarheid.
• Content-adressering — de CID is afgeleid van de bestandsinhoud zelf, wat onveranderlijkheid garandeert.
• Netwerkbrede toegankelijkheid — iedereen met de CID kan het bestand ophalen van elke IPFS-node.

Wat IPFS Ninja doet

IPFS Ninja is een beheerde service waarmee je bestanden kunt uploaden en bestaande content op IPFS kunt vastzetten via een eenvoudige REST API. Geen eigen IPFS-node nodig.

• Nieuwe bestanden uploaden — stuur elk bestand via POST /upload/new en ontvang een permanente CID
• Bestaande CID's vastzetten — heb je al content op IPFS? Zet het vast op ons cluster via POST /pin om ervoor te zorgen dat het beschikbaar blijft
• Toegang via gateway — alle vastgezette content is toegankelijk op ipfs.ninja/ipfs/<CID> (de apex-gateway bedient alleen CID's uit je eigen account of uit andere IPFS Ninja-accounts — zie Gateway-toegang hieronder)
• Aangepaste metadata — koppel sleutel-waardeparen aan uploads en pins voor organisatie en filtering
• Ondertekende upload-tokens — genereer tijdgelimiteerde tokens voor client-side uploads zonder je API-sleutel bloot te stellen
• IPNS veranderlijke namen — maak stabiele namen die verwijzen naar veranderende CID's via de IPNS API, met tot 10 namen per account
• Beeldoptimalisatie — wijzig de grootte, converteer en comprimeer afbeeldingen direct via gateway-URL-parameters

Dashboard

Volg uploads, opslag en gateway-bandbreedte vanuit je persoonlijke dashboard. Het dashboard laat je ook het grootste deel van de API bedienen zonder code te schrijven:

• Drag-and-drop-upload — bestanden, mappen (verpakt tot een UnixFS-directory in je browser), of .car-archieven
• Hernoem bestanden na upload; de beschrijving wordt automatisch ingevuld vanuit de bestandsnaam bij selectie
• Snapshot een map om één directory-CID te krijgen voor alles erin
• Configureer S3 CORS per bucket via een formuliereditor (voor integraties met browser-SDK's)
• Beheer API-sleutels, gateway-tokens, IPNS-namen en dedicated-gateway-instellingen

Gateway-toegang

Elk geüpload bestand is toegankelijk via de IPFS Ninja-gateway, die fungeert als brug tussen het gedecentraliseerde IPFS-netwerk en traditionele webbrowsers.

De gateway-URL volgt dit patroon:

https://ipfs.ninja/ipfs/<CID>

Bereik van de apex-gateway

De apex-gateway op https://ipfs.ninja/ipfs/<CID> bedient alleen CID's die zijn geüpload of vastgezet door een geregistreerde IPFS Ninja-gebruiker. Verzoeken voor elke andere CID geven HTTP 410 Gone terug met een verwijzing naar publieke IPFS-gateways zoals ipfs.io of dweb.link. Om een CID van een derde partij via onze gateway te serveren, meld je gratis aan en doe eerst POST /pin op je account.

TIP

Je bestanden zijn ook toegankelijk via elke publieke IPFS-gateway (bijv. dweb.link, w3s.link) met dezelfde CID — het IPFS-netwerk is gedecentraliseerd.

Alle betaalde plannen krijgen een dedicated gateway op hun eigen subdomein (<slug>.gw.ipfs.ninja) die alleen bestanden serveert die aan hun account zijn vastgezet — met optionele tokengebaseerde toegangscontrole en origin-beperkingen. De dedicated gateway is de aanbevolen URL voor productie-embedding (video's, NFT-viewers, websites).

Ondersteunde bestandstypen

Type	Formaten	Invoer
JSON	Elk geldig JSON-object of -array	string / object
Afbeeldingen	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF's	Standaard PDF-documenten	base64
HTML	HTML-documenten	base64
Alles	Elk bestand (binair, tekst, video, enz.)	base64

Alle bestandstypen worden geaccepteerd. Het type wordt automatisch gedetecteerd en geregistreerd voor je eigen referentie.

Beveiliging

Gateway-responsen bevatten beveiligingsheaders (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) die voorkomen dat browsers scripts uitvoeren in geserveerde content.