IPFS Ninja

Pugeu fàcilment imatges, PDF i fitxers JSON a IPFS i obteniu un identificador de contingut permanent (CID) amb accés instantani al gateway.

Què és IPFS?

L'InterPlanetary File System (IPFS) és un protocol d'emmagatzematge descentralitzat, peer-to-peer. IPFS divideix els fitxers en trossos més petits, els distribueix per tota la xarxa i assigna a cada fitxer un identificador de contingut (CID) únic basat en el seu contingut.

Això significa:

• Emmagatzematge distribuït — els vostres fitxers s'emmagatzemen en múltiples nodes per a una millor fiabilitat.
• Adreçament per contingut — el CID es deriva del contingut del fitxer en si, garantint la immutabilitat.
• Accessibilitat a tota la xarxa — qualsevol persona amb el CID pot recuperar el fitxer des de qualsevol node IPFS.

Què fa IPFS Ninja

IPFS Ninja és un servei gestionat que us permet pujar fitxers i fixar contingut existent a IPFS a través d'una REST API senzilla. No cal executar el vostre propi node IPFS.

• Pugeu fitxers nous — envieu qualsevol fitxer mitjançant POST /upload/new i obteniu un CID permanent
• Fixeu CID existents — ja teniu contingut a IPFS? Fixeu-lo al nostre clúster mitjançant POST /pin per assegurar que segueixi disponible
• Accés via gateway — tot el contingut fixat és accessible a ipfs.ninja/ipfs/<CID> (la passarel·la apex només serveix CIDs del teu compte o d'altres comptes d'IPFS Ninja — consulta Accés al gateway més avall)
• Metadata personalitzades — adjunteu parells clau-valor a les pujades i fixacions per a organització i filtratge
• Tokens de pujada signats — genereu tokens amb temps limitat per a pujades del costat del client sense exposar la vostra API key
• IPNS noms mutables — creeu noms estables que apuntin a CID canviants mitjançant IPNS API, amb fins a 10 noms per compte
• Optimització d'imatge — redimensioneu, convertiu i comprimiu imatges sobre la marxa mitjançant paràmetres d'URL del gateway

Tauler de control

Feu seguiment de les pujades, l'emmagatzematge i l'amplada de banda del gateway des del vostre tauler de control personal.

Accés al Gateway

Cada fitxer pujat és accessible a través del IPFS Ninja gateway, que actua com a pont entre la xarxa descentralitzada IPFS i els navegadors web tradicionals.

L'URL del gateway segueix aquest patró:

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

Abast de la passarel·la apex

La passarel·la apex a https://ipfs.ninja/ipfs/<CID> només serveix CIDs que han estat pujats o fixats per un usuari registrat d'IPFS Ninja. Les sol·licituds per a qualsevol altre CID retornen HTTP 410 Gone amb un punter a gateways IPFS públics com ipfs.io o dweb.link. Per servir un CID de tercers a través del nostre gateway, registra't gratis i fes primer POST /pin al teu compte.

TIP

Els vostres fitxers també són accessibles des de qualsevol gateway IPFS públic (p. ex. dweb.link, w3s.link) utilitzant el mateix CID — la xarxa IPFS és descentralitzada.

Els usuaris del pla Nirvana obtenen un gateway dedicat al seu propi subdomini (<slug>.gw.ipfs.ninja) que només serveix fitxers fixats al seu compte — amb control d'accés opcional basat en tokens i restriccions d'origen.

Tipus de fitxers suportats

Tipus	Formats	Entrada
JSON	Qualsevol objecte o matriu JSON vàlid	string / object
Imatges	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Documents PDF estàndard	base64
HTML	Documents HTML	base64
Qualsevol	Qualsevol fitxer (binary, text, video, etc.)	base64

S'accepten tots els tipus de fitxers. El tipus es detecta automàticament i es registra per a la vostra referència.

Seguretat

Les respostes del gateway inclouen capçaleres de seguretat (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) que impedeixen als navegadors executar scripts en el contingut servit.