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

Naghahain ba ang ipfs.ninja/ipfs/<CID> ng anumang CID sa IPFS network?

Hindi. Ang apex gateway ay nagsisilbi lamang ng mga CID na na-upload o na-pin ng isang user ng IPFS Ninja. Ang mga request para sa hindi kilalang CID ay nagbabalik ng HTTP 410 Gone na may pointer sa mga pampublikong IPFS gateway (ipfs.io, dweb.link). Upang maghain ng CID ng third party sa pamamagitan ng aming gateway, mag-POST /pin muna sa iyong account — kapag na-pin na, ang CID ay magiging naa-access sa parehong apex at sa URL ng iyong dedicated gateway.

Ano ang pagkakaiba ng apex gateway at dedicated gateway?

Aspeto	Apex ipfs.ninja/ipfs/<CID>	Dedicated <slug>.gw.ipfs.ninja/ipfs/<CID>
Saklaw	Ibinabahagi sa lahat ng user	Mga CID mo lamang
Authentication	Wala	Opsyonal na token / IP allowlist / origin allowlist
SLA	Best-effort	Buong SLA
Inirerekomenda para sa	Mga casual na link	Production embedding (NFT, video, mga website)
Rate limits	Ibinabahagi per IP + per CID	Per plan, configurable

Pareho silang naghahain ng magkaparehong nilalaman. Para sa production traffic, gamitin ang dedicated gateway.

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.

Bakit nagbago ang aking mga bagong CID mula sa Qm... patungong bafy...?

Ang mga bagong upload at pin ay nagbabalik ng modernong CIDv1 (bafk… para sa maliit na single-block na nilalaman, bafy… para sa mas malalaking file at directory) ayon sa IPIP-0499 unixfs-v1-2025 profile: CIDv1 base32 encoding, 1 MiB na chunks, raw leaves. Katugma ito sa ginagawa ng modernong tooling (Helia, pinakabagong Kubo, ipfs-car) para sa parehong nilalaman, kaya ang file na na-upload sa amin ay makakakuha ng parehong CID na kakalkulahin ng anumang modernong client para sa parehong bytes.

Ang legacy Qm… na mga CID mula sa mga naunang upload ay nananatiling ganap na resolvable — tinatanggap ng gateway, POST /pin, GET /file, IPNS, at bawat ibang endpoint ang parehong format nang walang katapusan. Walang tumitigil sa paggana sa mayroon ka nang ngayon.

Paano ko ipipin ang nilalaman na nasa private / non-DHT na node?

Tumatanggap ang POST /pin ng opsyonal na multiaddresses[] (hanggang 5). Kung ibinigay, ginagawa ng aming cluster ang ipfs swarm connect <multiaddr> para sa bawat hint bago tumakbo ang pin, kaya ang nilalaman sa mga peer na hindi nag-a-advertise sa pamamagitan ng pampublikong DHT (private nodes, staging environments, VPN-local na mga makina) ay maaabot. Tingnan ang Pin from a private IPFS node na gabay.

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?

Available ang mga dedicated gateway sa lahat ng bayad na plan (Bodhi $5/buwan, Karma $19/buwan, Nirvana $59/buwan). Sinasaklaw ng monthly bandwidth quota ng bawat plan ang traffic mula sa parehong apex at dedicated gateway. Tingnan ang "Mayroon bang bandwidth fee?" sa ibaba para sa quota bawat plan.

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 metered bandwidth fee sa anumang plan. Ang bawat plan ay may kasamang monthly gateway bandwidth quota na isang hard cap — huminto sa pagse-serve ang iyong nilalaman sa apex at dedicated gateway kapag naabot na ang quota, at nagpapatuloy ulit sa ika-1 ng susunod na buwan o pagkatapos ng pag-upgrade:

Plan	Monthly bandwidth
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Makakatanggap ka ng mga warning email sa 80% at 100% ng iyong quota.

Nagre-reset ba ang storage?

Hindi nagre-reset ang storage. Ang iyong plan ay may kasamang kabuuang storage allowance (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). 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.