IPFS Ninja

Sube fácilmente imágenes, PDFs y archivos JSON a IPFS y obtén 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 — envía cualquier archivo mediante POST /upload/new y obtén un CID permanente
• Fijar CIDs existentes — ¿ya tienes contenido en IPFS? Fíjalo 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> (el gateway apex solo sirve CIDs de tu cuenta o de otras cuentas de IPFS Ninja — consulta Acceso al gateway más abajo)
• 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

Dashboard

Rastrea subidas, almacenamiento y ancho de banda del gateway desde tu panel de control personal. El dashboard también te permite manejar la mayor parte de la API sin escribir código:

• Subida por arrastrar y soltar — archivos, carpetas (empaquetadas en un directorio UnixFS en tu navegador) o archivos .car
• Renombra archivos después de subirlos; la descripción se autocompleta a partir del nombre del archivo al seleccionarlo
• Crea un snapshot de una carpeta para obtener un único CID de directorio con todo su contenido
• Configura S3 CORS por bucket mediante un editor de formulario (para integraciones con SDK en navegador)
• Gestiona claves API, tokens de gateway, nombres IPNS y configuración del gateway dedicado

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>

Alcance del gateway apex

El gateway apex en https://ipfs.ninja/ipfs/<CID> solo sirve CIDs que han sido subidos o fijados por un usuario registrado de IPFS Ninja. Las solicitudes para cualquier otro CID devuelven HTTP 410 Gone con un puntero a gateways IPFS públicos como ipfs.io o dweb.link. Para servir un CID de terceros a través de nuestro gateway, regístrate gratis y haz primero POST /pin a tu cuenta.

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.

Todos los planes de pago 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. El gateway dedicado es la URL recomendada para incrustación en producción (videos, visores de NFT, sitios web).

Tipos de archivo 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.