IPFS Ninja

Carica facilmente immagini, PDF e file JSON su IPFS e ottieni un identificatore di contenuto permanente (CID) con accesso immediato tramite gateway.

Cos'è IPFS?

L'InterPlanetary File System (IPFS) è un protocollo di archiviazione decentralizzato e peer-to-peer. IPFS suddivide i file in parti più piccole, le distribuisce attraverso la rete e assegna a ciascun file un identificatore di contenuto (CID) unico basato sul suo contenuto.

Questo significa:

• Archiviazione distribuita — i tuoi file sono archiviati su più nodi per una maggiore affidabilità.
• Indirizzamento per contenuto — il CID deriva dal contenuto stesso del file, garantendo l'immutabilità.
• Accessibilità su tutta la rete — chiunque possieda il CID può recuperare il file da qualsiasi nodo IPFS.

Cosa fa IPFS Ninja

IPFS Ninja è un servizio gestito che ti permette di caricare file e pinnare contenuti esistenti su IPFS tramite una semplice API REST. Non è necessario eseguire il proprio nodo IPFS.

• Carica nuovi file — invia qualsiasi file tramite POST /upload/new e ottieni un CID permanente
• Pinna CID esistenti — hai già contenuti su IPFS? Pinnali al nostro cluster tramite POST /pin per assicurarti che rimangano disponibili
• Accesso tramite gateway — tutti i contenuti pinnati sono accessibili su ipfs.ninja/ipfs/<CID> (il gateway apex serve solo i CID del tuo account o di altri account IPFS Ninja — vedi Accesso al gateway sotto)
• Metadati personalizzati — allega coppie chiave-valore ai caricamenti e ai pin per organizzazione e filtraggio
• Token di caricamento firmati — genera token a tempo limitato per caricamenti lato client senza esporre la tua API key
• Nomi mutabili IPNS — crea nomi stabili che puntano a CID variabili tramite l'API IPNS, con un massimo di 10 nomi per account
• Ottimizzazione immagini — ridimensiona, converti e comprimi immagini al volo tramite parametri URL del gateway

Dashboard

Monitora caricamenti, archiviazione e larghezza di banda del gateway dalla tua dashboard personale. La dashboard ti permette anche di gestire gran parte dell'API senza scrivere codice:

• Caricamento drag-and-drop — file, cartelle (impacchettate in una directory UnixFS nel browser) o archivi .car
• Rinomina i file dopo il caricamento; la descrizione si compila automaticamente dal nome del file alla selezione
• Snapshot di una cartella per ottenere un unico CID di directory per tutto il contenuto
• Configura CORS S3 per bucket tramite un editor a modulo (per integrazioni con SDK browser)
• Gestisci API key, token gateway, nomi IPNS e impostazioni del gateway dedicato

Accesso al gateway

Ogni file caricato è accessibile tramite il gateway IPFS Ninja, che funge da ponte tra la rete IPFS decentralizzata e i browser web tradizionali.

L'URL del gateway segue questo schema:

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

Ambito del gateway apex

Il gateway apex su https://ipfs.ninja/ipfs/<CID> serve solo i CID che sono stati caricati o pinnati da un utente registrato di IPFS Ninja. Le richieste per qualsiasi altro CID restituiscono HTTP 410 Gone con un puntatore a gateway IPFS pubblici come ipfs.io o dweb.link. Per servire un CID di terze parti tramite il nostro gateway, registrati gratis e fai prima POST /pin sul tuo account.

TIP

I tuoi file sono accessibili anche da qualsiasi gateway IPFS pubblico (es. dweb.link, w3s.link) utilizzando lo stesso CID — la rete IPFS è decentralizzata.

Tutti i piani a pagamento ottengono un gateway dedicato sul proprio sottodominio (<slug>.gw.ipfs.ninja) che serve solo i file pinnati al proprio account — con controllo di accesso opzionale basato su token e restrizioni di origine. Il gateway dedicato è l'URL consigliato per l'incorporazione in produzione (video, visualizzatori NFT, siti web).

Tipi di file supportati

Tipo	Formati	Input
JSON	Qualsiasi oggetto o array JSON valido	string / object
Immagini	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Documenti PDF standard	base64
HTML	Documenti HTML	base64
Qualsiasi	Qualsiasi file (binario, testo, video, ecc.)	base64

Tutti i tipi di file sono accettati. Il tipo viene rilevato automaticamente e registrato per tuo riferimento.

Sicurezza

Le risposte del gateway includono header di sicurezza (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) che impediscono ai browser di eseguire script nei contenuti serviti.