IPFS Ninja

Laden Sie ganz einfach Bilder, PDFs und JSON-Dateien auf IPFS hoch und erhalten Sie einen permanenten Content Identifier (CID) mit sofortigem Gateway-Zugang.

Was ist IPFS?

Das InterPlanetary File System (IPFS) ist ein dezentrales Peer-to-Peer-Speicherprotokoll. IPFS zerlegt Dateien in kleinere Teile, verteilt sie im Netzwerk und weist jeder Datei einen einzigartigen Content Identifier (CID) basierend auf ihrem Inhalt zu.

Das bedeutet:

• Verteilte Speicherung — Ihre Dateien werden auf mehreren Knoten gespeichert, was die Zuverlässigkeit verbessert.
• Inhaltsbasierte Adressierung — Der CID wird aus dem Dateiinhalt selbst abgeleitet und gewährleistet Unveränderlichkeit.
• Netzwerkweite Zugänglichkeit — Jeder mit dem CID kann die Datei von jedem IPFS-Knoten abrufen.

Was IPFS Ninja leistet

IPFS Ninja ist ein verwalteter Dienst, mit dem Sie Dateien hochladen und bestehende Inhalte auf IPFS über eine einfache REST API pinnen können. Sie müssen keinen eigenen IPFS-Knoten betreiben.

• Neue Dateien hochladen — senden Sie eine beliebige Datei über POST /upload/new und erhalten Sie einen permanenten CID
• Bestehende CIDs pinnen — haben Sie bereits Inhalte auf IPFS? Pinnen Sie sie über POST /pin an unseren Cluster, um die Verfügbarkeit sicherzustellen
• Zugriff über Gateway — alle gepinnten Inhalte sind unter ipfs.ninja/ipfs/<CID> erreichbar (das Apex-Gateway bedient nur CIDs aus Ihrem Konto oder aus anderen IPFS-Ninja-Konten — siehe Gateway-Zugang unten)
• Benutzerdefinierte Metadaten — fügen Sie Schlüssel-Wert-Paare zu Uploads und Pins hinzu, um sie zu organisieren und zu filtern
• Signierte Upload-Token — generieren Sie zeitlich begrenzte Token für clientseitige Uploads, ohne Ihren API-Schlüssel preiszugeben
• IPNS veränderbare Namen — erstellen Sie stabile Namen, die über die IPNS API auf wechselnde CIDs verweisen, mit bis zu 10 Namen pro Konto
• Bildoptimierung — skalieren, konvertieren und komprimieren Sie Bilder on-the-fly über Gateway-URL-Parameter

Dashboard

Verfolgen Sie Uploads, Speicherplatz und Gateway-Bandbreite über Ihr persönliches Dashboard. Über das Dashboard können Sie zudem die meiste API-Funktionalität nutzen, ohne Code zu schreiben:

• Drag-and-Drop-Upload — Dateien, Ordner (in Ihrem Browser zu einem UnixFS-Verzeichnis gepackt) oder .car-Archive
• Umbenennen von Dateien nach dem Upload; die Beschreibung wird bei der Auswahl automatisch aus dem Dateinamen befüllt
• Snapshot eines Ordners, um einen einzigen Verzeichnis-CID für den gesamten Inhalt zu erhalten
• S3 CORS konfigurieren pro Bucket über einen Formular-Editor (für Browser-SDK-Integrationen)
• Verwalten von API-Schlüsseln, Gateway-Token, IPNS-Namen und Einstellungen für dedizierte Gateways

Gateway-Zugang

Jede hochgeladene Datei ist über das IPFS Ninja Gateway zugänglich, das als Brücke zwischen dem dezentralen IPFS-Netzwerk und herkömmlichen Webbrowsern dient.

Die Gateway-URL folgt diesem Muster:

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

Geltungsbereich des Apex-Gateways

Das Apex-Gateway unter https://ipfs.ninja/ipfs/<CID> bedient nur CIDs, die von einem registrierten IPFS-Ninja-Nutzer hochgeladen oder gepinnt wurden. Anfragen für andere CIDs geben HTTP 410 Gone zurück, mit einem Verweis auf öffentliche IPFS-Gateways wie ipfs.io oder dweb.link. Um einen Drittpartei-CID über unser Gateway bereitzustellen, registrieren Sie sich kostenlos und führen Sie zuerst POST /pin für Ihr Konto aus.

TIP

Ihre Dateien sind auch über jedes öffentliche IPFS-Gateway (z. B. dweb.link, w3s.link) mit demselben CID erreichbar — das IPFS-Netzwerk ist dezentral.

Alle kostenpflichtigen Pläne erhalten ein dediziertes Gateway unter ihrer eigenen Subdomain (<slug>.gw.ipfs.ninja), das nur Dateien ausliefert, die mit ihrem Konto verknüpft sind — mit optionaler tokenbasierter Zugriffskontrolle und Origin-Einschränkungen. Das dedizierte Gateway ist die empfohlene URL für die Produktionseinbettung (Videos, NFT-Viewer, Websites).

Unterstützte Dateitypen

Typ	Formate	Eingabe
JSON	Jedes gültige JSON-Objekt oder -Array	string / object
Bilder	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDFs	Standard-PDF-Dokumente	base64
HTML	HTML-Dokumente	base64
Alle	Jede Datei (Binär, Text, Video usw.)	base64

Alle Dateitypen werden akzeptiert. Der Typ wird automatisch erkannt und für Ihre Referenz aufgezeichnet.

Sicherheit

Gateway-Antworten enthalten Sicherheitsheader (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), die verhindern, dass Browser Skripte in ausgelieferten Inhalten ausführen.