FAQ

Pertanyaan yang sering diajukan tentang IPFS Ninja.

Umum

Apa itu IPFS Ninja?

IPFS Ninja adalah layanan pinning IPFS terkelola. Anda mengunggah file apa pun melalui REST API sederhana, atau menyematkan CID yang ada dari jaringan IPFS. Setiap file mendapatkan content identifier (CID) permanen dan dapat diakses melalui gateway kami di ipfs.ninja/ipfs/<CID>.

Apakah ipfs.ninja/ipfs/<CID> melayani CID apa pun di jaringan IPFS?

Tidak. Gateway apex hanya melayani CID yang telah diunggah atau disematkan oleh pengguna IPFS Ninja. Permintaan untuk CID yang tidak dikenal mengembalikan HTTP 410 Gone dengan penunjuk ke gateway IPFS publik (ipfs.io, dweb.link). Untuk melayani CID pihak ketiga melalui gateway kami, lakukan POST /pin ke akun Anda terlebih dahulu — setelah disematkan, CID dapat diakses baik di URL apex maupun di URL gateway khusus Anda.

Apa perbedaan antara gateway apex dan gateway khusus?

Aspek	Apex ipfs.ninja/ipfs/<CID>	Khusus <slug>.gw.ipfs.ninja/ipfs/<CID>
Cakupan	Dibagikan di antara semua pengguna	Hanya CID Anda
Autentikasi	Tidak ada	Token opsional / IP allowlist / origin allowlist
SLA	Best-effort	SLA penuh
Direkomendasikan untuk	Tautan kasual	Penyematan produksi (NFT, video, situs web)
Batas kecepatan	Dibagikan per IP + per CID	Per paket, dapat dikonfigurasi

Keduanya melayani konten yang identik. Untuk lalu lintas produksi, gunakan gateway khusus.

Jenis file apa yang didukung?

Semua jenis file didukung. Objek dan array JSON dapat dikirim langsung. Semua file lainnya (gambar, PDF, HTML, video, audio, biner) dikirim sebagai konten yang dienkode base64.

Apakah ada batas ukuran file?

Unggahan individual dibatasi oleh alokasi penyimpanan paket Anda. Tidak ada batas ukuran per file selain penyimpanan yang tersedia.

Bisakah saya menyematkan konten yang sudah ada di IPFS?

Ya. Gunakan POST /pin dengan CID valid apa pun. Kluster kami akan mengambil konten dari jaringan IPFS dan menyematkannya ke akun Anda. Lihat dokumentasi API Pinning untuk detail.

Berapa lama waktu pinning?

Tergantung pada ukuran file dan berapa banyak node IPFS yang memiliki konten tersebut. File kecil yang terdistribusi dengan baik disematkan dalam hitungan detik. Konten besar atau yang jarang disematkan mungkin memerlukan beberapa menit. Endpoint pin langsung mengembalikan dengan status pinning — polling GET /pin/:cid untuk memeriksa progres.

Apa yang terjadi jika CID tidak dapat ditemukan?

Status berubah menjadi failed. Ini berarti CID tidak valid atau konten tidak lagi tersedia di node IPFS mana pun yang dapat dijangkau.

Apakah data yang diunggah ke IPFS bersifat publik?

Ya. Semua konten yang disematkan ke IPFS dapat diakses secara publik melalui CID-nya melalui gateway IPFS mana pun. Jika Anda memerlukan akses privat, gunakan gateway khusus dengan mode token-required — ini membatasi akses melalui gateway Anda, meskipun konten tetap tersedia di jaringan IPFS yang lebih luas.

Mengapa CID baru saya berubah dari Qm... menjadi bafy...?

Unggahan dan pin baru mengembalikan CIDv1 modern (bafk… untuk konten satu-blok kecil, bafy… untuk file dan direktori yang lebih besar) sesuai profil IPIP-0499 unixfs-v1-2025: pengkodean base32 CIDv1, chunk 1 MiB, raw leaves. Ini sesuai dengan apa yang dihasilkan tooling modern (Helia, Kubo terbaru, ipfs-car) untuk konten yang sama, sehingga file yang diunggah melalui kami mendapatkan CID yang sama seperti yang akan dihitung klien modern mana pun untuk byte yang sama.

CID Qm… lama dari unggahan sebelumnya tetap sepenuhnya dapat diresolusi — gateway, POST /pin, GET /file, IPNS, dan setiap endpoint lainnya menerima kedua format tanpa batas waktu. Tidak ada yang sudah Anda miliki berhenti berfungsi.

Bagaimana cara menyematkan konten yang berada di node privat / non-DHT?

POST /pin menerima multiaddresses[] opsional (hingga 5). Jika disediakan, kluster kami menjalankan ipfs swarm connect <multiaddr> untuk setiap hint sebelum pin berjalan, sehingga konten pada peer yang tidak mengiklankan diri melalui DHT publik (node privat, lingkungan staging, mesin lokal VPN) dapat dijangkau. Lihat panduan Sematkan dari node IPFS privat.

Apakah file saya akan tetap di IPFS jika saya membatalkan akun?

Kami melepas pin file Anda dari node kami saat Anda membatalkan. Jika node IPFS lain telah meng-cache konten Anda, konten tersebut mungkin tetap dapat diakses. Namun, tanpa pinning aktif, file pada akhirnya akan dihapus oleh garbage collection di seluruh jaringan.

Autentikasi & API

Bagaimana cara mengautentikasi permintaan API?

Kirimkan API key Anda melalui header X-Api-Key. Buat key dari halaman API Keys di dashboard Anda.

Apakah ada batas laju API?

Tidak. IPFS Ninja tidak memberlakukan batas laju pada permintaan API. Anda dapat membuat permintaan sebanyak yang Anda butuhkan pada paket apa pun.

Apakah API key kedaluwarsa?

Tidak. API key berlaku sampai Anda menghapusnya. Anda dapat membuat beberapa key dan mencabutnya satu per satu.

Apa perbedaan antara API key dan token gateway?

API key (bws_) memiliki akses penuh — unggah, hapus, daftar file. Token gateway (gwt_) hanya-baca dan hanya dapat mengakses file melalui gateway khusus Anda. Token gateway aman untuk disematkan di aplikasi frontend.

Gateway Khusus

Apa itu gateway khusus?

Gateway IPFS privat di subdomain Anda sendiri (misalnya abc123.gw.ipfs.ninja) yang hanya melayani file yang disematkan ke akun Anda. Berbeda dengan gateway publik, gateway ini tidak akan me-resolve CID dari pengguna lain.

Paket mana yang menyertakan gateway khusus?

Gateway khusus tersedia di semua paket berbayar (Bodhi $5/bulan, Karma $19/bulan, Nirvana $59/bulan). Kuota bandwidth bulanan setiap paket mencakup lalu lintas dari gateway apex maupun gateway khusus. Lihat "Apakah ada biaya bandwidth?" di bawah untuk kuota per paket.

Bisakah saya membatasi siapa yang mengakses gateway saya?

Ya. Anda dapat mengaktifkan mode token-required (memerlukan token gwt_ pada setiap permintaan) dan/atau mengatur whitelist IP (hingga 100 alamat).

Bisakah saya membatasi gateway berdasarkan origin/domain?

Ya. Konfigurasikan allowedOrigins di pengaturan gateway Anda dengan daftar origin HTTPS. Hanya permintaan browser dari origin tersebut yang akan diizinkan. Permintaan non-browser (tanpa header Origin) lewat tanpa batasan. Daftar kosong mengizinkan semua origin.

Apa itu token unggah bertanda tangan?

Token unggah bertanda tangan adalah kredensial terbatas waktu untuk unggahan sisi klien. Anda membuatnya di server menggunakan POST /upload/signed-url dan meneruskannya ke browser atau aplikasi mobile. Klien mengautentikasi dengan Authorization: Signed <token> alih-alih mengekspos API key Anda. Setiap token melacak penggunaan dan kedaluwarsa secara otomatis. Lihat dokumentasi Token Bertanda Tangan untuk detail.

Bisakah saya mengoptimalkan gambar yang dilayani dari IPFS?

Ya. Gunakan GET /image/:cid dengan parameter kueri seperti w, h, format, dan quality untuk mengubah ukuran, mengonversi, dan mengompres gambar secara langsung. Respons di-cache berdasarkan CID yang content-addressed. Ini berfungsi di semua paket. Lihat Optimasi Gambar.

Bisakah saya melampirkan metadata ke file?

Ya. Sertakan objek metadata dengan hingga 10 pasangan kunci-nilai saat mengunggah melalui POST /upload/new atau menyematkan melalui POST /pin. Metadata dikembalikan dalam daftar file dan endpoint detail file. Lihat dokumentasi File dan Pinning.

Tagihan & Paket

Apakah ada paket gratis?

Ya. Paket Dharma gratis selamanya — 1 GB penyimpanan, permintaan API tidak terbatas, tidak memerlukan kartu kredit.

Apakah ada biaya bandwidth?

Tidak ada biaya bandwidth terukur pada paket apa pun. Setiap paket menyertakan kuota bandwidth gateway bulanan yang merupakan batas keras — konten Anda berhenti dilayani di gateway apex dan gateway khusus setelah kuota tercapai, dan dilanjutkan kembali pada tanggal 1 bulan berikutnya atau setelah upgrade:

Paket	Bandwidth bulanan
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Anda akan menerima email peringatan pada 80% dan 100% dari kuota Anda.

Apakah penyimpanan direset?

Penyimpanan tidak direset. Paket Anda mencakup alokasi penyimpanan total (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Untuk membebaskan ruang, hapus file yang tidak lagi Anda butuhkan. Meningkatkan paket akan menambah alokasi total Anda.

Bisakah saya membatalkan kapan saja?

Ya. Batalkan langganan Anda melalui portal tagihan — tanpa keterikatan. Akun Anda kembali ke tingkat gratis, dan file yang sudah disematkan tetap dapat diakses.

Apa yang terjadi pada file saya jika saya menurunkan paket?

File Anda tetap disematkan di IPFS, tetapi Anda tidak dapat mengunggah lebih banyak jika penggunaan saat ini melebihi batas penyimpanan paket baru. Hapus file untuk kembali di bawah batas.

Keamanan

Apakah data saya dienkripsi?

Semua data dienkripsi saat transit melalui TLS/HTTPS. Autentikasi menggunakan token JWT (Cognito) dan API key yang disimpan secara aman. Konten file di IPFS tidak dienkripsi saat diam — IPFS secara desain adalah jaringan publik.

Apakah aman menggunakan API key di kode sisi server saya?

Ya. API key dirancang untuk penggunaan sisi server. Jangan pernah mengeksposnya di kode sisi klien. Untuk akses file sisi klien, gunakan token gateway (gwt_) yang hanya-baca.

Dukungan

Bagaimana cara mendapatkan bantuan?

Email info@ipfs.ninja atau periksa dokumentasi Referensi API.

Apakah ada SLA?

Kami berusaha untuk ketersediaan tinggi tetapi saat ini tidak menawarkan SLA formal. Layanan disediakan atas dasar "apa adanya".