IPFS Ninja

Łatwo przesyłaj obrazy, pliki PDF i JSON do IPFS i uzyskaj stały identyfikator treści (CID) z natychmiastowym dostępem przez bramkę.

Czym jest IPFS?

InterPlanetary File System (IPFS) to zdecentralizowany protokół przechowywania peer-to-peer. IPFS dzieli pliki na mniejsze fragmenty, rozprowadza je po sieci i przypisuje każdemu plikowi unikalny identyfikator treści (CID) oparty na jego zawartości.

Oznacza to:

• Rozproszone przechowywanie — twoje pliki są przechowywane na wielu węzłach dla lepszej niezawodności.
• Adresowanie treści — CID jest wyprowadzany z samej treści pliku, zapewniając niezmienność.
• Dostępność w całej sieci — każdy, kto ma CID, może pobrać plik z dowolnego węzła IPFS.

Co robi IPFS Ninja

IPFS Ninja to zarządzana usługa, która pozwala przesyłać pliki i przypinać istniejącą treść w IPFS przez proste API REST. Nie trzeba uruchamiać własnego węzła IPFS.

• Przesyłaj nowe pliki — wyślij dowolny plik przez POST /upload/new i uzyskaj stały CID
• Przypinaj istniejące CID — masz już treść na IPFS? Przypnij ją do naszego klastra przez POST /pin, aby zapewnić jej dostępność
• Dostęp przez bramkę — cała przypięta treść jest dostępna pod ipfs.ninja/ipfs/<CID> (bramka apex obsługuje tylko CID-y z Twojego konta lub z innych kont IPFS Ninja — patrz Dostęp do bramki poniżej)
• Niestandardowe metadane — dołącz pary klucz-wartość do przesłań i przypięć dla organizacji i filtrowania
• Podpisane tokeny przesyłania — generuj tokeny z ograniczonym czasem dla przesyłania po stronie klienta bez ujawniania klucza API
• Zmienne nazwy IPNS — twórz stabilne nazwy wskazujące na zmieniające się CID przez API IPNS, z maksymalnie 10 nazwami na konto
• Optymalizacja obrazów — zmieniaj rozmiar, konwertuj i kompresuj obrazy w locie przez parametry URL bramki

Dashboard

Śledź przesyłania, przechowywanie i przepustowość bramki z osobistego panelu. Dashboard pozwala też obsłużyć większość API bez pisania kodu:

• Przesyłanie przeciągnij-i-upuść — pliki, foldery (pakowane do katalogu UnixFS w Twojej przeglądarce) lub archiwa .car
• Zmiana nazwy plików po przesłaniu; opis wypełnia się automatycznie z nazwy pliku po wybraniu
• Migawka folderu, aby uzyskać jeden CID katalogu dla wszystkiego w środku
• Konfiguracja S3 CORS per bucket przez edytor formularzowy (dla integracji z SDK w przeglądarce)
• Zarządzanie kluczami API, tokenami bramki, nazwami IPNS i ustawieniami dedykowanej bramki

Dostęp przez bramkę

Każdy przesłany plik jest dostępny przez bramkę IPFS Ninja, która działa jako most między zdecentralizowaną siecią IPFS a tradycyjnymi przeglądarkami internetowymi.

URL bramki ma następujący format:

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

Zakres bramki apex

Bramka apex pod adresem https://ipfs.ninja/ipfs/<CID> obsługuje tylko CID-y, które zostały przesłane lub przypięte przez zarejestrowanego użytkownika IPFS Ninja. Żądania dotyczące innych CID-ów zwracają HTTP 410 Gone ze wskaźnikiem do publicznych bramek IPFS, takich jak ipfs.io czy dweb.link. Aby udostępniać CID osoby trzeciej przez naszą bramkę, zarejestruj się za darmo i najpierw wykonaj POST /pin na swoje konto.

TIP

Twoje pliki są również dostępne z dowolnej publicznej bramki IPFS (np. dweb.link, w3s.link) przy użyciu tego samego CID — sieć IPFS jest zdecentralizowana.

Wszystkie płatne plany otrzymują dedykowaną bramkę na własnej subdomenie (<slug>.gw.ipfs.ninja), która obsługuje tylko pliki przypięte do ich konta — z opcjonalną kontrolą dostępu opartą na tokenach i ograniczeniami pochodzenia. Dedykowana bramka jest zalecanym URL-em do osadzania produkcyjnego (filmy, przeglądarki NFT, strony internetowe).

Obsługiwane typy plików

Typ	Formaty	Wejście
JSON	Dowolny prawidłowy obiekt lub tablica JSON	string / object
Obrazy	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Standardowe dokumenty PDF	base64
HTML	Dokumenty HTML	base64
Dowolny	Dowolny plik (binarny, tekstowy, wideo itp.)	base64

Wszystkie typy plików są akceptowane. Typ jest automatycznie wykrywany i rejestrowany.

Bezpieczeństwo

Odpowiedzi bramki zawierają nagłówki bezpieczeństwa (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), które uniemożliwiają przeglądarkom wykonywanie skryptów w serwowanej treści.