FAQ

Mga madalas itanong tungkol sa IPFS Ninja.

Pangkalahatan

Ano ang IPFS Ninja?

Ang IPFS Ninja ay isang managed IPFS pinning service. Maaari kang mag-upload ng anumang file sa pamamagitan ng simpleng REST API, o mag-pin ng umiiral na CID mula sa IPFS network. Ang bawat file ay nakakakuha ng permanenteng content identifier (CID) at accessible sa pamamagitan ng aming gateway sa ipfs.ninja/ipfs/<CID>.

Anong mga uri ng file ang suportado?

Lahat ng uri ng file ay suportado. Ang mga JSON object at array ay maaaring ipadala nang direkta. Lahat ng iba pang file (imahe, PDF, HTML, video, audio, binary) ay ipinapadala bilang base64-encoded na nilalaman.

Mayroon bang limitasyon sa laki ng file?

Ang mga indibidwal na upload ay limitado ng storage allowance ng iyong plan. Walang per-file na limitasyon sa laki maliban sa iyong available na storage.

Maaari ko bang i-pin ang nilalaman na umiiral na sa IPFS?

Oo. Gamitin ang POST /pin na may anumang valid na CID. Kukunin ng aming cluster ang nilalaman mula sa IPFS network at i-pin ito sa iyong account. Tingnan ang Pinning API docs para sa mga detalye.

Gaano katagal ang pag-pin?

Depende sa laki ng file at kung gaano karaming IPFS node ang may nilalaman. Ang maliliit, magandang distributed na file ay napi-pin sa loob ng ilang segundo. Ang malalaki o bihirang na-pin na nilalaman ay maaaring tumagal ng ilang minuto. Agad na nagbabalik ang pin endpoint na may status na pinning — i-poll ang GET /pin/:cid para suriin ang progreso.

Ano ang mangyayari kung hindi mahanap ang isang CID?

Ang status ay magiging failed. Ibig sabihin, ang CID ay hindi wasto o ang nilalaman ay hindi na available sa anumang maaaring maabot na IPFS node.

Ang data ba na na-upload sa IPFS ay pampubliko?

Oo. Lahat ng nilalaman na naka-pin sa IPFS ay publicly accessible sa pamamagitan ng CID nito sa anumang IPFS gateway. Kung kailangan mo ng pribadong access, gumamit ng dedicated gateway na may token-required mode — nirestrict nito ang access sa pamamagitan ng iyong gateway, bagama't ang nilalaman ay nananatiling available sa mas malawak na IPFS network.

Mananatili ba ang aking mga file sa IPFS kung kanselahin ko ang aking account?

I-unpin namin ang iyong mga file mula sa aming mga node kapag nagkansel ka. Kung nag-cache ng iyong nilalaman ang ibang IPFS node, maaaring manatili itong accessible. Gayunpaman, kung walang aktibong pinning, ang mga file ay aalisin ng garbage collection sa katagalan sa buong network.

Authentication at API

Paano ko ia-authenticate ang mga API request?

Ipasa ang iyong API key sa pamamagitan ng X-Api-Key header. Bumuo ng mga key mula sa API Keys page sa iyong dashboard.

Mayroon bang API rate limit?

Wala. Hindi nagpapataw ng rate limit ang IPFS Ninja sa mga API request. Maaari kang gumawa ng gaanong karaming request sa anumang plan.

Nag-e-expire ba ang mga API key?

Hindi. Ang mga API key ay valid hanggang tanggalin mo. Maaari kang gumawa ng maraming key at i-revoke ang mga ito nang isa-isa.

Ano ang pagkakaiba ng mga API key at gateway token?

Ang mga API key (bws_) ay may buong access — upload, delete, list files. Ang mga gateway token (gwt_) ay read-only at maaari lang mag-access ng mga file sa pamamagitan ng iyong dedicated gateway. Ang mga gateway token ay ligtas na i-embed sa mga frontend app.

Mga Dedicated Gateway

Ano ang dedicated gateway?

Isang pribadong IPFS gateway sa iyong sariling subdomain (hal. abc123.gw.ipfs.ninja) na nagse-serve lang ng mga file na naka-pin sa iyong account. Hindi tulad ng public gateway, hindi nito ire-resolve ang mga CID mula sa ibang user.

Anong mga plan ang may kasamang dedicated gateway?

Ang mga dedicated gateway ay available sa Nirvana plan ($29/buwan), na may kasamang 50 GB/buwang gateway bandwidth.

Maaari ko bang limitahan kung sino ang maka-access sa aking gateway?

Oo. Maaari mong i-enable ang token-required mode (kailangan ng gwt_ token sa bawat request) at/o mag-set ng IP whitelist (hanggang 100 address).

Maaari ko bang limitahan ang aking gateway ayon sa origin/domain?

Oo. I-configure ang allowedOrigins sa iyong gateway settings na may listahan ng mga HTTPS origin. Tanging ang mga browser request mula sa mga origin na iyon ang papayagan. Ang mga non-browser request (walang Origin header) ay dumadaan nang walang restriction. Ang walang laman na listahan ay nagpapahintulot sa lahat ng origin.

Ano ang mga signed upload token?

Ang mga signed upload token ay time-limited na credential para sa client-side uploads. Ginagawa mo ang mga ito sa iyong server gamit ang POST /upload/signed-url at ipinapasa sa mga browser o mobile app. Ang client ay nag-a-authenticate na may Authorization: Signed <token> sa halip na i-expose ang iyong API key. Ang bawat token ay nagta-track ng usage at awtomatikong nag-e-expire. Tingnan ang Signed Tokens docs para sa mga detalye.

Maaari ko bang i-optimize ang mga imahe na served mula sa IPFS?

Oo. Gamitin ang GET /image/:cid na may query parameter tulad ng w, h, format, at quality para mag-resize, mag-convert, at mag-compress ng mga imahe on-the-fly. Ang mga response ay naka-cache batay sa content-addressed CID. Gumagana ito sa lahat ng plan. Tingnan ang Image Optimization.

Maaari ko bang mag-attach ng metadata sa mga file?

Oo. Isama ang metadata object na may hanggang 10 key-value pair kapag nag-upload sa pamamagitan ng POST /upload/new o nag-pin sa pamamagitan ng POST /pin. Ang metadata ay ibinabalik sa mga file listing at file detail endpoint. Tingnan ang Files at Pinning docs.

Billing at Mga Plan

Mayroon bang libreng plan?

Oo. Ang Dharma plan ay libre magpakailanman — 1 GB ng storage, walang limitasyong API request, hindi kailangan ng credit card.

Mayroon bang bandwidth fee?

Walang bandwidth fee sa mga API request para sa anumang plan. Ang dedicated gateway bandwidth (Nirvana plan) ay may kasama nang 50 GB/buwan. Kapag naabot ang limit, ang mga gateway request ay bini-block hanggang sa susunod na buwan.

Nagre-reset ba ang storage?

Hindi nagre-reset ang storage. Ang iyong plan ay may kasamang kabuuang storage allowance (1 GB / 10 GB / 100 GB). Para magpalaya ng espasyo, mag-delete ng mga file na hindi mo na kailangan. Ang pag-upgrade ng iyong plan ay nagdadagdag ng iyong kabuuang allowance.

Maaari ko bang kanselahin anumang oras?

Oo. Kanselahin ang iyong subscription sa pamamagitan ng billing portal — walang lock-in. Ang iyong account ay babalik sa libreng tier, at ang mga naka-pin na file ay nananatiling accessible.

Ano ang mangyayari sa aking mga file kung mag-downgrade ako?

Ang iyong mga file ay nananatiling naka-pin sa IPFS, ngunit hindi ka makakapag-upload ng dagdag kung ang kasalukuyang paggamit mo ay lumalampas sa storage limit ng bagong plan. Mag-delete ng mga file para bumalik sa ilalim ng limit.

Seguridad

Naka-encrypt ba ang aking data?

Lahat ng data ay naka-encrypt sa transit sa pamamagitan ng TLS/HTTPS. Ang authentication ay gumagamit ng JWT token (Cognito) at mga API key na naka-store nang ligtas. Ang file content sa IPFS ay hindi naka-encrypt at rest — ang IPFS ay pampublikong network sa disenyo.

Ligtas bang gamitin ang mga API key sa aking server-side code?

Oo. Ang mga API key ay dinisenyo para sa server-side na paggamit. Huwag itong i-expose sa client-side code. Para sa client-side na file access, gumamit ng mga gateway token (gwt_) na read-only.

Suporta

Paano ako makakakuha ng tulong?

Mag-email sa info@ipfs.ninja o tingnan ang API Reference na dokumentasyon.

Mayroon bang SLA?

Nagsisikap kami para sa mataas na availability ngunit hindi nag-aalok ng pormal na SLA sa kasalukuyan. Ang serbisyo ay ibinibigay sa "as is" na batayan.