Soalan Lazim

Soalan lazim tentang IPFS Ninja.

Umum

Apa itu IPFS Ninja?

IPFS Ninja ialah perkhidmatan IPFS pinning terurus. Anda memuat naik sebarang fail melalui REST API yang mudah, atau menyemat CID sedia ada dari rangkaian IPFS. Setiap fail mendapat pengecam kandungan kekal (CID) dan boleh diakses melalui gateway kami di ipfs.ninja/ipfs/<CID>.

Apakah jenis fail yang disokong?

Semua jenis fail disokong. Objek dan tatasusunan JSON boleh dihantar secara langsung. Semua fail lain (imej, PDF, HTML, video, audio, binari) dihantar sebagai kandungan berkod base64.

Adakah terdapat had saiz fail?

Muat naik individu dihadkan oleh peruntukan storan pelan anda. Tiada had saiz per fail selain daripada storan yang tersedia.

Bolehkah saya menyemat kandungan yang sudah wujud di IPFS?

Ya. Gunakan POST /pin dengan mana-mana CID yang sah. Kluster kami akan mendapatkan kandungan dari rangkaian IPFS dan menyematkannya ke akaun anda. Lihat dokumentasi Pinning API untuk butiran.

Berapa lama masa penyematan?

Bergantung pada saiz fail dan berapa banyak nod IPFS yang mempunyai kandungan tersebut. Fail kecil yang teragih dengan baik disemat dalam beberapa saat. Kandungan besar atau jarang disemat mungkin mengambil beberapa minit. Endpoint pin mengembalikan segera dengan status pinning — poll GET /pin/:cid untuk menyemak kemajuan.

Apa yang berlaku jika CID tidak dapat dijumpai?

Status berubah kepada failed. Ini bermakna CID sama ada tidak sah atau kandungan tidak lagi tersedia pada mana-mana nod IPFS yang boleh dicapai.

Adakah data yang dimuat naik ke IPFS bersifat awam?

Ya. Semua kandungan yang disemat ke IPFS boleh diakses secara awam melalui CID-nya melalui mana-mana IPFS gateway. Jika anda memerlukan akses peribadi, gunakan gateway khusus dengan mod memerlukan token — ini mengehadkan akses melalui gateway anda, walaupun kandungan kekal tersedia di rangkaian IPFS yang lebih luas.

Adakah fail saya akan kekal di IPFS jika saya membatalkan akaun?

Kami menyahsemat fail anda dari nod kami apabila anda membatalkan. Jika nod IPFS lain telah meng-cache kandungan anda, ia mungkin masih boleh diakses. Walau bagaimanapun, tanpa penyematan aktif, fail akan akhirnya dikeluarkan oleh garbage collection di seluruh rangkaian.

Pengesahan & API

Bagaimana saya mengesahkan permintaan API?

Hantar API key anda melalui header X-Api-Key. Jana kunci dari halaman API Keys di papan pemuka anda.

Adakah terdapat had kadar API?

Tidak. IPFS Ninja tidak mengenakan had kadar pada permintaan API. Anda boleh membuat seberapa banyak permintaan yang anda perlukan pada mana-mana pelan.

Adakah API key luput?

Tidak. API key sah sehingga anda memadamkannya. Anda boleh mencipta berbilang kunci dan membatalkannya secara individu.

Apakah perbezaan antara API key dan gateway token?

API key (bws_) mempunyai akses penuh — muat naik, padam, senaraikan fail. Gateway token (gwt_) adalah baca sahaja dan hanya boleh mengakses fail melalui gateway khusus anda. Gateway token selamat untuk disematkan dalam aplikasi frontend.

Gateway Khusus

Apa itu gateway khusus?

Gateway IPFS peribadi di subdomain anda sendiri (cth. abc123.gw.ipfs.ninja) yang hanya menyajikan fail yang disemat ke akaun anda. Tidak seperti gateway awam, ia tidak akan menyelesaikan CID daripada pengguna lain.

Pelan manakah yang termasuk gateway khusus?

Gateway khusus tersedia pada pelan Nirvana ($29/bulan), yang termasuk 50 GB/bulan lebar jalur gateway.

Bolehkah saya mengehadkan siapa yang mengakses gateway saya?

Ya. Anda boleh mendayakan mod memerlukan token (memerlukan token gwt_ pada setiap permintaan) dan/atau menetapkan IP whitelist (sehingga 100 alamat).

Bolehkah saya mengehadkan gateway saya mengikut origin/domain?

Ya. Konfigurasikan allowedOrigins dalam tetapan gateway anda dengan senarai origin HTTPS. Hanya permintaan pelayar dari origin tersebut akan dibenarkan. Permintaan bukan pelayar (tanpa header Origin) melepasi tanpa sekatan. Senarai kosong membenarkan semua origin.

Apakah token muat naik bertandatangan?

Token muat naik bertandatangan ialah kelayakan terhad masa untuk muat naik sisi klien. Anda menjananya pada pelayan anda menggunakan POST /upload/signed-url dan menyerahkannya kepada pelayar atau aplikasi mudah alih. Klien mengesahkan dengan Authorization: Signed <token> dan bukannya mendedahkan API key anda. Setiap token menjejak penggunaan dan luput secara automatik. Lihat dokumentasi Signed Tokens untuk butiran.

Bolehkah saya mengoptimumkan imej yang disajikan dari IPFS?

Ya. Gunakan GET /image/:cid dengan parameter kueri seperti w, h, format, dan quality untuk mengubah saiz, menukar dan memampatkan imej secara on-the-fly. Respons di-cache berdasarkan CID beralamat kandungan. Ini berfungsi pada semua pelan. Lihat Pengoptimuman Imej.

Bolehkah saya melampirkan metadata pada fail?

Ya. Sertakan objek metadata dengan sehingga 10 pasangan kunci-nilai semasa memuat naik melalui POST /upload/new atau menyemat melalui POST /pin. Metadata dikembalikan dalam senarai fail dan endpoint perincian fail. Lihat dokumentasi Fail dan Penyematan.

Bil & Pelan

Adakah terdapat pelan percuma?

Ya. Pelan Dharma adalah percuma selamanya — 1 GB storan, permintaan API tanpa had, tiada kad kredit diperlukan.

Adakah terdapat bayaran lebar jalur?

Tiada bayaran lebar jalur untuk permintaan API bagi mana-mana pelan. Lebar jalur gateway khusus (pelan Nirvana) termasuk 50 GB/bulan. Apabila had dicapai, permintaan gateway disekat sehingga bulan berikutnya.

Adakah storan direset?

Storan tidak direset. Pelan anda termasuk jumlah peruntukan storan (1 GB / 10 GB / 100 GB). Untuk membebaskan ruang, padamkan fail yang tidak lagi anda perlukan. Menaik taraf pelan anda meningkatkan jumlah peruntukan anda.

Bolehkah saya membatalkan pada bila-bila masa?

Ya. Batalkan langganan anda melalui portal pengebilan — tiada ikatan. Akaun anda kembali ke peringkat percuma, dan fail yang disemat sedia ada kekal boleh diakses.

Apa yang berlaku kepada fail saya jika saya menurunkan taraf?

Fail anda kekal disemat ke IPFS, tetapi anda tidak boleh memuat naik lagi jika penggunaan semasa anda melebihi had storan pelan baharu. Padamkan fail untuk kembali di bawah had.

Keselamatan

Adakah data saya disulitkan?

Semua data disulitkan dalam transit melalui TLS/HTTPS. Pengesahan menggunakan JWT token (Cognito) dan API key yang disimpan dengan selamat. Kandungan fail di IPFS tidak disulitkan pada rehat — IPFS ialah rangkaian awam secara reka bentuk.

Adakah selamat menggunakan API key dalam kod sisi pelayan saya?

Ya. API key direka untuk kegunaan sisi pelayan. Jangan sekali-kali mendedahkannya dalam kod sisi klien. Untuk akses fail sisi klien, gunakan gateway token (gwt_) yang baca sahaja.

Sokongan

Bagaimana saya mendapatkan bantuan?

E-mel info@ipfs.ninja atau semak dokumentasi Rujukan API.

Adakah terdapat SLA?

Kami berusaha untuk ketersediaan tinggi tetapi tidak menawarkan SLA rasmi pada masa ini. Perkhidmatan ini disediakan atas dasar "seadanya".