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 instant 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 dvs. 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 dvs. 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

Dashboard

Urmăriți încărcările, stocarea și lățimea de bandă a gateway-ului din panoul dvs. personal de control. Dashboard-ul vă permite de asemenea să folosiți cea mai mare parte a API-ului fără a scrie cod:

• Încărcare prin tragere și plasare — fișiere, foldere (împachetate într-un director UnixFS în browserul dvs.), sau arhive .car
• Redenumire a fișierelor după încărcare; descrierea se completează automat din numele fișierului la selectare
• Instantaneu (snapshot) al unui folder pentru a obține un singur CID de director pentru tot conținutul din interior
• Configurare S3 CORS per bucket printr-un editor cu formular (pentru integrări cu SDK-ul de browser)
• Gestionare chei API, tokenuri gateway, nume IPNS și setări de gateway dedicat

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, înregistrați-vă gratuit și executați mai întâi POST /pin pe contul dvs.

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ă.

Toate planurile plătite 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. Gateway-ul dedicat este URL-ul recomandat pentru încorporarea în producție (videoclipuri, vizualizatoare NFT, site-uri web).

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-uri	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.