IPFS Ninja

Sube fácilmente imágenes, PDFs y archivos JSON a IPFS y obtiene un identificador de contenido permanente (CID) con acceso instantáneo a través del gateway.

¿Qué es IPFS?

El Sistema de Archivos Interplanetario (IPFS) es un protocolo de almacenamiento descentralizado entre pares. IPFS divide los archivos en fragmentos más pequeños, los distribuye a través de la red y asigna a cada archivo un identificador de contenido (CID) único basado en su contenido.

Esto significa:

• Almacenamiento distribuido — tus archivos se almacenan en múltiples nodos para mayor fiabilidad.
• Direccionamiento por contenido — el CID se deriva del contenido del archivo, garantizando su inmutabilidad.
• Accesibilidad en toda la red — cualquier persona con el CID puede recuperar el archivo desde cualquier nodo IPFS.

¿Qué hace IPFS Ninja

IPFS Ninja es un servicio gestionado que te permite subir archivos y fijar contenido existente en IPFS a través de una API REST sencilla. No necesitas ejecutar tu propio nodo IPFS.

• Subir nuevos archivos — envia cualquier archivo mediante POST /upload/new y obtén un CID permanente
• Fijar CIDs existentes — ya tienes contenido en IPFS? Fijalo a nuestro cluster mediante POST /pin para asegurar su disponibilidad
• Acceso a través del gateway — todo el contenido fijado es accesible en ipfs.ninja/ipfs/<CID>
• Metadatos personalizados — adjunta pares clave-valor a las subidas y fijaciones para organización y filtrado
• Tokens de subida firmados — genera tokens con tiempo limitado para subidas del lado del cliente sin exponer tu clave API
• Nombres mutables IPNS — crea nombres estables que apuntan a CIDs cambiantes mediante la API IPNS, con hasta 10 nombres por cuenta
• Optimización de imágenes — redimensiona, convierte y comprime imágenes al vuelo mediante parámetros de URL del gateway

Panel de control

Rastrea subidas, almacenamiento y ancho de banda del gateway desde tu panel de control personal.

Acceso al gateway

Cada archivo subido es accesible a través del gateway de IPFS Ninja, que actúa como puente entre la red descentralizada IPFS y los navegadores web tradicionales.

La URL del gateway sigue este patrón:

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

TIP

Tus archivos también son accesibles desde cualquier gateway público de IPFS (por ejemplo, dweb.link, w3s.link) usando el mismo CID — la red IPFS es descentralizada.

Los usuarios del plan Nirvana obtienen un gateway dedicado en su propio subdominio (<slug>.gw.ipfs.ninja) que solo sirve archivos fijados a su cuenta — con control de acceso opcional basado en tokens y restricciones de origen.

Tipos de archivos soportados

Tipo	Formatos	Entrada
JSON	Cualquier objeto o arreglo JSON válido	string / object
Imágenes	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDFs	Documentos PDF estándar	base64
HTML	Documentos HTML	base64
Cualquiera	Cualquier archivo (binario, texto, video, etc.)	base64

Se aceptan todos los tipos de archivo. El tipo se detecta automáticamente y se registra para tu referencia.

Seguridad

Las respuestas del gateway incluyen encabezados de seguridad (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) que evitan que los navegadores ejecuten scripts en el contenido servido.

Límites de tamaño

Límite	Valor
Payload máximo por solicitud	6 MB (límite de API Gateway)
Almacenamiento total (Dharma)	1 GB
Almacenamiento total (Bodhi)	10 GB
Almacenamiento total (Nirvana)	100 GB

Casos de uso

Metadatos y activos NFT

Almacena metadatos JSON de NFT e imágenes asociadas con CIDs permanentes e inmutables.

Alojamiento de recursos estáticos

Aloja imágenes, documentos y archivos de datos para aplicaciones web y móviles.

Comparticion verificable de datos

Comparte datos con procedencia direccionada por contenido — los destinatarios pueden verificar que nada fue alterado.