IPFS Ninja

Unggah gambar, PDF, dan file JSON ke IPFS dengan mudah dan dapatkan content identifier (CID) permanen dengan akses gateway instan.

Apa itu IPFS?

InterPlanetary File System (IPFS) adalah protokol penyimpanan terdesentralisasi berbasis peer-to-peer. IPFS memecah file menjadi bagian-bagian yang lebih kecil, mendistribusikannya di seluruh jaringan, dan memberikan setiap file content identifier (CID) unik berdasarkan isinya.

Ini berarti:

• Penyimpanan terdistribusi — file Anda disimpan di beberapa node untuk keandalan yang lebih baik.
• Content addressing — CID diturunkan dari konten file itu sendiri, menjamin immutabilitas.
• Aksesibilitas seluruh jaringan — siapa pun yang memiliki CID dapat mengambil file dari node IPFS mana pun.

Apa yang dilakukan IPFS Ninja

IPFS Ninja adalah layanan terkelola yang memungkinkan Anda mengunggah file dan menyematkan konten yang ada di IPFS melalui REST API sederhana. Tidak perlu menjalankan node IPFS sendiri.

• Unggah file baru — kirim file apa pun melalui POST /upload/new dan dapatkan CID permanen
• Sematkan CID yang ada — sudah memiliki konten di IPFS? Sematkan ke kluster kami melalui POST /pin untuk memastikan tetap tersedia
• Akses melalui gateway — semua konten yang disematkan dapat diakses di ipfs.ninja/ipfs/<CID> (gateway apex hanya melayani CID di akun Anda atau di akun IPFS Ninja lainnya — lihat Akses gateway di bawah)
• Metadata kustom — lampirkan pasangan kunci-nilai ke unggahan dan pin untuk organisasi dan pemfilteran
• Token unggah bertanda tangan — buat token terbatas waktu untuk unggahan sisi klien tanpa mengekspos API key Anda
• Nama IPNS yang dapat diubah — buat nama stabil yang menunjuk ke CID yang berubah melalui API IPNS, hingga 10 nama per akun
• Optimasi gambar — ubah ukuran, konversi, dan kompres gambar secara langsung melalui parameter URL gateway

Dashboard

Pantau unggahan, penyimpanan, dan bandwidth gateway dari dashboard pribadi Anda. Dashboard juga memungkinkan Anda menjalankan sebagian besar API tanpa menulis kode:

• Unggah drag-and-drop — file, folder (dikemas menjadi direktori UnixFS di browser Anda), atau arsip .car
• Ganti nama file setelah diunggah; deskripsi otomatis terisi dari nama file saat dipilih
• Snapshot folder untuk mendapatkan satu CID direktori untuk semua isinya
• Konfigurasikan S3 CORS per bucket melalui editor berbasis form (untuk integrasi SDK browser)
• Kelola API key, token gateway, nama IPNS, dan pengaturan gateway khusus

Akses gateway

Setiap file yang diunggah dapat diakses melalui gateway IPFS Ninja, yang berfungsi sebagai jembatan antara jaringan IPFS terdesentralisasi dan browser web tradisional.

URL gateway mengikuti pola ini:

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

Cakupan gateway apex

Gateway apex di https://ipfs.ninja/ipfs/<CID> hanya melayani CID yang telah diunggah atau disematkan oleh pengguna IPFS Ninja terdaftar. Permintaan untuk CID lainnya mengembalikan HTTP 410 Gone dengan penunjuk ke gateway IPFS publik seperti ipfs.io atau dweb.link. Untuk melayani CID pihak ketiga melalui gateway kami, daftar gratis dan lakukan POST /pin ke akun Anda terlebih dahulu.

TIP

File Anda juga dapat diakses dari gateway IPFS publik mana pun (misalnya dweb.link, w3s.link) menggunakan CID yang sama — jaringan IPFS terdesentralisasi.

Semua paket berbayar mendapatkan gateway khusus di subdomain mereka sendiri (<slug>.gw.ipfs.ninja) yang hanya melayani file yang disematkan ke akun mereka — dengan kontrol akses berbasis token opsional dan pembatasan origin. Gateway khusus adalah URL yang direkomendasikan untuk penyematan produksi (video, penampil NFT, situs web).

Jenis file yang didukung

Jenis	Format	Input
JSON	Objek atau array JSON valid apa pun	string / object
Gambar	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Dokumen PDF standar	base64
HTML	Dokumen HTML	base64
Apa pun	File apa pun (biner, teks, video, dll.)	base64

Semua jenis file diterima. Jenis file terdeteksi secara otomatis dan dicatat untuk referensi Anda.

Keamanan

Respons gateway menyertakan header keamanan (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) yang mencegah browser mengeksekusi skrip dalam konten yang dilayani.