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'e' IPFS?

L'InterPlanetary File System (IPFS) e' un protocollo di archiviazione decentralizzato e peer-to-peer. IPFS suddivide i file in parti piu' piccole, li 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 piu' nodi per una maggiore affidabilita'.
• Indirizzamento per contenuto — il CID deriva dal contenuto stesso del file, garantendo l'immutabilita'.
• Accessibilita' su tutta la rete — chiunque possieda il CID puo' recuperare il file da qualsiasi nodo IPFS.

Cosa fa IPFS Ninja

IPFS Ninja e' un servizio gestito che ti permette di caricare file e pinnare contenuti esistenti su IPFS tramite una semplice API REST. Non e' 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 gia' 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>
• 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 fino a 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.

Accesso al gateway

Ogni file caricato e' 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>

TIP

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

Gli utenti del piano Nirvana 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.

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.

Limiti di dimensione

Limite	Valore
Payload massimo per richiesta	6 MB (limite API Gateway)
Archiviazione totale (Dharma)	1 GB
Archiviazione totale (Bodhi)	10 GB
Archiviazione totale (Nirvana)	100 GB

Casi d'uso

Metadati e risorse NFT

Archivia metadati JSON degli NFT e le immagini associate con CID permanenti e immutabili.

Hosting di risorse statiche

Ospita immagini, documenti e file di dati per applicazioni web e mobile.

Condivisione di dati verificabili

Condividi dati con provenienza indirizzata per contenuto — i destinatari possono verificare che nulla sia stato manomesso.