Questions Fréquentes

Questions fréquemment posees sur IPFS Ninja.

General

Qu'est-ce qu'IPFS Ninja ?

IPFS Ninja est un service géré d'épinglage IPFS. Vous téléchargez n'importe quel fichier via une API REST simple, ou épinglez des CIDs existants du réseau IPFS. Chaque fichier reçoit un identifiant de contenu permanent (CID) et est accessible via notre gateway a ipfs.ninja/ipfs/<CID>.

Quels types de fichiers sont pris en charge ?

Tous les types de fichiers sont pris en charge. Les objets et tableaux JSON peuvent etre envoyés directement. Tous les autres fichiers (images, PDFs, HTML, video, audio, binaires) sont envoyés en contenu encodé en base64.

Y a-t-il une limite de taille de fichier ?

Les téléversements individuels sont limites par la capacité de stockage de votre plan. Il n'y a pas de limite de taille par fichier au-dela de votre stockage disponible.

Puis-je épingler du contenu qui existe deja sur IPFS ?

Oui. Utilisez POST /pin avec n'importe quel CID valide. Notre cluster recuperera le contenu du réseau IPFS et l'epinglera sur votre compte. Consultez la documentation de l'API d'Épinglage pour plus de details.

Combien de temps prend l'épinglage ?

Cela depend de la taille du fichier et du nombre de nœuds IPFS ayant le contenu. Les petits fichiers bien distribues s'épinglent en quelques secondes. Le contenu volumineux ou rarement épinglé peut prendre quelques minutes. Le endpoint d'épinglage repond immédiatement avec le statut pinning — consultez GET /pin/:cid pour vérifier la progression.

Que se passe-t-il si un CID ne peut pas etre trouve ?

Le statut passe a failed. Cela signifie que le CID est invalide ou que le contenu n'est plus disponible sûr aucun nœud IPFS accessible.

Les données telechargees sur IPFS sont-elles publiques ?

Oui. Tout contenu épinglé sur IPFS est accessible publiquement via son CID depuis n'importe quel gateway IPFS. Si vous avez besoin d'un accès privé, utilisez un gateway dédié avec le mode token requis — cela restreint l'accès via votre gateway, bien que le contenu reste disponible sur le réseau IPFS plus large.

Mes fichiers restent-ils sur IPFS si j'annule mon compte ?

Nous désépinglons vos fichiers de nos nœuds lorsque vous annulez. Si d'autres nœuds IPFS ont mis en cache votre contenu, il peut rester accessible. Cependant, sans épinglage actif, les fichiers seront finalement supprimes par le ramasse-miettes du réseau.

Authentification et API

Comment authentifier les requêtes API ?

Passez votre clé API via l'en-tête X-Api-Key. Générez des clés depuis la page Clés API de votre tableau de bord.

Y a-t-il des limites de débit sur l'API ?

Non. IPFS Ninja n'impose pas de limites de débit sur les requêtes API. Vous pouvez faire autant de requêtes que nécessaire sur n'importe quel plan.

Les clés API expirent-elles ?

Non. Les clés API sont valides jusqu'à ce que vous les supprimiez. Vous pouvez créer plusieurs clés et les revoquer individuellement.

Quelle est la difference entre les clés API et les tokens de gateway ?

Les clés API (bws_) ont un accès complet — téléversement, suppression, listage des fichiers. Les tokens de gateway (gwt_) sont en lecture seule et ne peuvent accéder aux fichiers que via votre gateway dédié. Les tokens de gateway sont sûrs a intégrer dans les applications frontend.

Gateways Dédiés

Qu'est-ce qu'un gateway dédié ?

Un gateway IPFS privé sur votre propre sous-domaine (par exemple abc123.gw.ipfs.ninja) qui ne sert que les fichiers épinglés sur votre compte. Contrairement au gateway public, il ne resoudra pas les CIDs d'autres utilisateurs.

Quels plans incluent un gateway dédié ?

Les gateways dédiés sont disponibles avec le plan Nirvana (29 $/mois), qui comprend 50 Go/mois de bande passante gateway.

Puis-je restreindre qui accede a mon gateway ?

Oui. Vous pouvez activer le mode token requis (nécessité un token gwt_ pour chaque requête) et/ou configurer une liste blanche d'IPs (jusqu'à 100 adresses).

Puis-je restreindre mon gateway par origine/domaine ?

Oui. Configurez allowedOrigins dans les paramètres de votre gateway avec une liste d'origines HTTPS. Seules les requêtes de navigateur provenant de ces origines seront autorisées. Les requêtes non-navigateur (sans en-tête Origin) passent sans restriction. Une liste vide autorisé toutes les origines.

Que sont les tokens de téléversement signes ?

Les tokens de téléversement signes sont des identifiants à durée limitee pour les téléversements côté client. Vous les générez sur votre serveur en utilisant POST /upload/signed-url et les transmettez aux navigateurs ou applications mobiles. Le client s'authentifie avec Authorization: Signed <token> au lieu d'exposer votre clé API. Chaque token suit l'utilisation et expire automatiquement. Consultez la documentation des Tokens Signes pour plus de details.

Puis-je optimiser les images servies depuis IPFS ?

Oui. Utilisez GET /image/:cid avec des paramètres de requête comme w, h, format et quality pour redimensionner, convertir et compresser des images à la volée. Les réponses sont mises en cache en fonction du CID adresse par contenu. Cela fonctionne sur tous les plans. Consultez Optimisation d'Images.

Puis-je attacher des métadonnées aux fichiers ?

Oui. Incluez un objet metadata avec jusqu'à 10 paires clé-valeur lors du téléversement via POST /upload/new ou de l'épinglage via POST /pin. Les métadonnées sont retournées dans les listages de fichiers et le endpoint de detail du fichier. Consultez la documentation des Fichiers et de l'Épinglage.

Facturation et Plans

Existe-t-il un plan gratuit ?

Oui. Le plan Dharma est gratuit pour toujours — 1 Go de stockage, requêtes API illimitees, sans carte de credit requise.

Y a-t-il des frais de bande passante ?

Aucun frais de bande passante sur les requêtes API pour aucun plan. La bande passante du gateway dédié (plan Nirvana) comprend 50 Go/mois. Lorsque la limite est atteinte, les requêtes gateway sont bloquées jusqu'au mois suivant.

Le stockage se réinitialisé-t-il ?

Le stockage ne se réinitialisé pas. Votre plan comprend une capacité de stockage totale (1 Go / 10 Go / 100 Go). Pour liberer de l'espace, supprimez les fichiers dont vous n'avez plus besoin. La mise à niveau de votre plan augmente votre capacité totale.

Puis-je annuler à tout moment ?

Oui. Annulez votre abonnement via le portail de facturation — sans engagement. Votre compte revient au niveau gratuit, et les fichiers épinglés existants restent accessibles.

Que se passe-t-il avec mes fichiers si je rétrogradez ?

Vos fichiers restent épinglés sur IPFS, mais vous ne pourrez plus téléverser si votre utilisation actuelle dépassé la limite de stockage du nouveau plan. Supprimez des fichiers pour revenir en dessous de la limite.

Sécurité

Mes données sont-elles chiffrées ?

Toutes les données sont chiffrées en transit via TLS/HTTPS. L'authentification utilise des tokens JWT (Cognito) et des clés API stockees en toute sécurité. Le contenu des fichiers sur IPFS n'est pas chiffré au repos — IPFS est un réseau public par conception.

Est-il sur d'utiliser des clés API dans mon code côté serveur ?

Oui. Les clés API sont conçues pour une utilisation côté serveur. Ne les exposez jamais dans du code côté client. Pour l'accès aux fichiers côté client, utilisez des tokens de gateway (gwt_) qui sont en lecture seule.

Support

Comment obtenir de l'aide ?

Envoyez un e-mail a info@ipfs.ninja ou consultez la documentation de la Référence de l'API.

Y a-t-il un SLA ?

Nous nous efforcons d'assurer une haute disponibilité mais ne proposons pas de SLA formel pour le moment. Le service est fourni "tel quel".