IPFS Ninja

Téléversez facilement des images, des PDF et des fichiers JSON sur IPFS et obtenez un identifiant de contenu (CID) permanent avec un accès instantané via gateway.

Qu'est-ce qu'IPFS ?

Le système de fichiers interplanétaire (InterPlanetary File System, IPFS) est un protocole de stockage décentralisé et pair à pair. IPFS découpe les fichiers en fragments plus petits, les distribue à travers le réseau et attribue à chaque fichier un identifiant de contenu (CID) unique basé sur son contenu.

Cela signifie :

• Stockage distribué — vos fichiers sont stockés sur plusieurs nœuds pour une meilleure fiabilité.
• Adressage par contenu — le CID est dérivé du contenu du fichier lui-même, garantissant l'immuabilité.
• Accessibilité à l'échelle du réseau — toute personne disposant du CID peut récupérer le fichier depuis n'importe quel nœud IPFS.

Ce que fait IPFS Ninja

IPFS Ninja est un service géré qui vous permet de téléverser des fichiers et d'épingler du contenu existant sur IPFS via une API REST simple. Pas besoin d'exécuter votre propre nœud IPFS.

• Téléverser de nouveaux fichiers — envoyez n'importe quel fichier via POST /upload/new et obtenez un CID permanent
• Épingler des CID existants — vous avez déjà du contenu sur IPFS ? Épinglez-le sur notre cluster via POST /pin pour garantir sa disponibilité
• Accès via gateway — tout le contenu épinglé est accessible à ipfs.ninja/ipfs/<CID> (le gateway apex ne sert que les CID de votre compte ou d'autres comptes IPFS Ninja — voir Accès au gateway ci-dessous)
• Métadonnées personnalisées — attachez des paires clé-valeur aux téléversements et épinglages pour l'organisation et le filtrage
• Tokens de téléversement signés — générez des tokens à durée limitée pour les téléversements côté client sans exposer votre clé API
• Noms mutables IPNS — créez des noms stables qui pointent vers des CID changeants via l'API IPNS, jusqu'à 10 noms par compte
• Optimisation d'images — redimensionnez, convertissez et compressez des images à la volée via les paramètres d'URL du gateway

Tableau de bord

Suivez les téléversements, le stockage et la bande passante du gateway depuis votre tableau de bord personnel. Le tableau de bord vous permet aussi de piloter la majeure partie de l'API sans écrire de code :

• Téléversement par glisser-déposer — fichiers, dossiers (regroupés dans un répertoire UnixFS dans votre navigateur), ou archives .car
• Renommer des fichiers après téléversement ; la description se remplit automatiquement à partir du nom de fichier lors de la sélection
• Créer un instantané d'un dossier pour obtenir un seul CID de répertoire pour tout son contenu
• Configurer CORS S3 par bucket via un éditeur de formulaire (pour les intégrations via SDK navigateur)
• Gérer les clés API, les tokens de gateway, les noms IPNS et les paramètres de gateway dédié

Accès au gateway

Chaque fichier téléversé est accessible via le gateway IPFS Ninja, qui sert de pont entre le réseau décentralisé IPFS et les navigateurs web traditionnels.

L'URL du gateway suit ce modèle :

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

Portée du gateway apex

Le gateway apex à https://ipfs.ninja/ipfs/<CID> ne sert que les CID qui ont été téléversés ou épinglés par un utilisateur enregistré d'IPFS Ninja. Les requêtes pour tout autre CID renvoient HTTP 410 Gone avec un pointeur vers des gateways IPFS publics comme ipfs.io ou dweb.link. Pour servir un CID tiers via notre gateway, inscrivez-vous gratuitement et faites d'abord POST /pin sur votre compte.

TIP

Vos fichiers sont également accessibles depuis n'importe quel gateway IPFS public (par ex. dweb.link, w3s.link) en utilisant le même CID — le réseau IPFS est décentralisé.

Tous les plans payants bénéficient d'un gateway dédié sur leur propre sous-domaine (<slug>.gw.ipfs.ninja) qui ne sert que les fichiers épinglés à leur compte — avec un contrôle d'accès optionnel par token et des restrictions d'origine. Le gateway dédié est l'URL recommandée pour l'intégration en production (vidéos, visionneuses de NFT, sites web).

Types de fichiers pris en charge

Type	Formats	Entrée
JSON	Tout objet ou tableau JSON valide	string / object
Images	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Documents PDF standard	base64
HTML	Documents HTML	base64
Tout	Tout fichier (binaire, texte, vidéo, etc.)	base64

Tous les types de fichiers sont acceptés. Le type est détecté automatiquement et enregistré pour votre référence.

Sécurité

Les réponses du gateway incluent des en-têtes de sécurité (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) qui empêchent les navigateurs d'exécuter des scripts dans le contenu servi.