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

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.

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 pada paket Nirvana ($29/bulan), yang mencakup 50 GB/bulan bandwidth gateway.

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. 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 pada permintaan API untuk paket apa pun. Bandwidth gateway khusus (paket Nirvana) mencakup 50 GB/bulan. Ketika batas tercapai, permintaan gateway diblokir hingga bulan berikutnya.

Apakah penyimpanan direset?

Penyimpanan tidak direset. Paket Anda mencakup alokasi penyimpanan total (1 GB / 10 GB / 100 GB). 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".