IPFS Ninja

Încărcați cu ușurință imagini, PDF-uri și fișiere JSON pe IPFS și obțineți un identificator de conținut permanent (CID) cu acces instantaneu prin gateway.

Ce este IPFS?

InterPlanetary File System (IPFS) este un protocol de stocare descentralizat, peer-to-peer. IPFS împarte fișierele în fragmente mai mici, le distribuie în rețea și atribuie fiecărui fișier un identificator de conținut (CID) unic bazat pe conținutul său.

Aceasta înseamnă:

• Stocare distribuită — fișierele dvs. sunt stocate pe mai multe noduri pentru o fiabilitate îmbunătățită.
• Adresare prin conținut — CID-ul este derivat din conținutul fișierului în sine, asigurând imuabilitatea.
• Accesibilitate la nivel de rețea — oricine cu CID-ul poate prelua fișierul de la orice nod IPFS.

Ce face IPFS Ninja

IPFS Ninja este un serviciu gestionat care vă permite să încărcați fișiere și să fixați conținut existent pe IPFS printr-un API REST simplu. Nu este nevoie să rulați propriul nod IPFS.

• Încărcarea fișierelor noi — trimiteți orice fișier prin POST /upload/new și obțineți un CID permanent
• Fixarea CID-urilor existente — aveți deja conținut pe IPFS? Fixați-l în clusterul nostru prin POST /pin pentru a-l menține disponibil
• Acces prin gateway — tot conținutul fixat este accesibil la ipfs.ninja/ipfs/<CID> (gateway-ul apex servește doar CID-uri din contul tău sau din alte conturi IPFS Ninja — vezi Acces gateway mai jos)
• Metadate personalizate — atașați perechi cheie-valoare la încărcări și fixări pentru organizare și filtrare
• Tokenuri de încărcare semnate — generați tokenuri cu durată limitată pentru încărcări pe partea de client fără a expune cheia API
• Nume mutabile IPNS — creați nume stabile care indică spre CID-uri în schimbare prin IPNS API, până la 10 nume per cont
• Optimizarea imaginilor — redimensionați, convertiți și comprimați imaginile din mers prin parametrii URL gateway

Panou de control

Urmăriți încărcările, stocarea și lățimea de bandă a gateway-ului din panoul dvs. personal de control.

Acces prin gateway

Fiecare fișier încărcat este accesibil prin gateway-ul IPFS Ninja, care acționează ca o punte între rețeaua descentralizată IPFS și browserele web tradiționale.

URL-ul gateway-ului urmează acest model:

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

Domeniul gateway-ului apex

Gateway-ul apex la https://ipfs.ninja/ipfs/<CID> servește doar CID-uri care au fost încărcate sau fixate de un utilizator IPFS Ninja înregistrat. Cererile pentru orice alt CID returnează HTTP 410 Gone cu un indicator către gateway-uri IPFS publice precum ipfs.io sau dweb.link. Pentru a servi un CID terț prin gateway-ul nostru, înregistrează-te gratuit și execută mai întâi POST /pin pe contul tău.

TIP

Fișierele dvs. sunt de asemenea accesibile de la orice gateway IPFS public (de ex. dweb.link, w3s.link) folosind același CID — rețeaua IPFS este descentralizată.

Utilizatorii planului Nirvana primesc un gateway dedicat pe propriul subdomeniu (<slug>.gw.ipfs.ninja) care servește doar fișierele fixate în contul lor — cu control opțional al accesului bazat pe tokenuri și restricții de origine.

Tipuri de fișiere acceptate

Tip	Formate	Intrare
JSON	Orice obiect sau array JSON valid	string / object
Imagini	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Documente PDF standard	base64
HTML	Documente HTML	base64
Orice	Orice fișier (binar, text, video etc.)	base64

Toate tipurile de fișiere sunt acceptate. Tipul este detectat automat și înregistrat pentru referința dvs.

Securitate

Răspunsurile gateway-ului includ anteturi de securitate (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) care împiedică browserele să execute scripturi în conținutul servit.