IPFS Ninja

Madaling mag-upload ng mga imahe, PDF, at JSON file sa IPFS at makakuha ng permanenteng content identifier (CID) na may instant na gateway access.

Ano ang IPFS?

Ang InterPlanetary File System (IPFS) ay isang desentralisado, peer-to-peer na storage protocol. Hinahati ng IPFS ang mga file sa mas maliliit na bahagi, ipinamamahagi ang mga ito sa buong network, at nagbibigay ng natatanging content identifier (CID) sa bawat file batay sa nilalaman nito.

Ibig sabihin nito:

• Distributed na storage — ang iyong mga file ay nakaimbak sa maraming node para sa mas maaasahang reliability.
• Content addressing — ang CID ay nagmula sa mismong nilalaman ng file, tinitiyak ang immutability.
• Network-wide na accessibility — sinumang may CID ay makakakuha ng file mula sa anumang IPFS node.

Ano ang ginagawa ng IPFS Ninja

Ang IPFS Ninja ay isang managed service na nagbibigay-daan sa iyo na mag-upload ng mga file at mag-pin ng umiiral na nilalaman sa IPFS sa pamamagitan ng simpleng REST API. Hindi na kailangang magpatakbo ng sarili mong IPFS node.

• Mag-upload ng bagong file — magpadala ng anumang file sa pamamagitan ng POST /upload/new at makakuha ng permanenteng CID
• Mag-pin ng umiiral na CID — mayroon nang nilalaman sa IPFS? I-pin ito sa aming cluster sa pamamagitan ng POST /pin para matiyak na mananatiling available
• Access sa pamamagitan ng gateway — lahat ng naka-pin na nilalaman ay accessible sa ipfs.ninja/ipfs/<CID> (ang apex gateway ay nagsisilbi lamang ng mga CID sa iyong account o sa iba pang IPFS Ninja account — tingnan ang Pag-access sa gateway sa ibaba)
• Custom metadata — mag-attach ng key-value pairs sa mga upload at pin para sa organisasyon at pag-filter
• Signed upload tokens — bumuo ng time-limited na mga token para sa client-side uploads nang hindi ine-expose ang iyong API key
• IPNS mutable names — lumikha ng matatag na mga pangalan na nakaturo sa mga nagbabagong CID sa pamamagitan ng IPNS API, na may hanggang 10 pangalan bawat account
• Image optimization — mag-resize, mag-convert, at mag-compress ng mga imahe on-the-fly sa pamamagitan ng gateway URL parameters

Dashboard

Subaybayan ang mga upload, storage, at gateway bandwidth mula sa iyong personal na dashboard. Nagbibigay-daan din ang dashboard na i-drive ang karamihan ng API nang hindi sumusulat ng code:

• Drag-and-drop na upload — mga file, folder (pinapackage sa isang UnixFS directory sa iyong browser), o mga .car archive
• Palitan ng pangalan ang mga file pagkatapos ng upload; awtomatikong napupuno ang paglalarawan mula sa pangalan ng file sa pagpili
• I-snapshot ang isang folder para makakuha ng iisang directory CID para sa lahat ng laman nito
• I-configure ang S3 CORS bawat bucket sa pamamagitan ng form editor (para sa mga browser SDK integration)
• Pamahalaan ang mga API key, gateway token, IPNS name, at dedicated gateway settings

Gateway access

Bawat na-upload na file ay accessible sa pamamagitan ng IPFS Ninja gateway, na nagsisilbing tulay sa pagitan ng desentralisadong IPFS network at mga tradisyonal na web browser.

Ang gateway URL ay sumusunod sa pattern na ito:

https://ipfs.ninja/ipfs/<CID>

Saklaw ng apex gateway

Ang apex gateway sa https://ipfs.ninja/ipfs/<CID> ay nagsisilbi lamang ng mga CID na na-upload o na-pin ng isang rehistradong user ng IPFS Ninja. Ang mga request para sa iba pang CID ay nagbabalik ng HTTP 410 Gone na may pointer sa mga pampublikong IPFS gateway tulad ng ipfs.io o dweb.link. Upang maghain ng CID ng third party sa pamamagitan ng aming gateway, mag-sign up nang libre at mag-POST /pin muna sa iyong account.

TIP

Ang iyong mga file ay accessible din mula sa anumang pampublikong IPFS gateway (hal. dweb.link, w3s.link) gamit ang parehong CID — ang IPFS network ay desentralisado.

Lahat ng bayad na plan ay may dedicated gateway sa kanilang sariling subdomain (<slug>.gw.ipfs.ninja) na nagse-serve lang ng mga file na naka-pin sa kanilang account — na may opsyonal na token-based access control at origin restrictions. Ang dedicated gateway ang inirerekomendang URL para sa production embedding (mga video, NFT viewer, website).

Mga suportadong uri ng file

Uri	Mga Format	Input
JSON	Anumang valid na JSON object o array	string / object
Mga Imahe	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Mga karaniwang PDF document	base64
HTML	Mga HTML document	base64
Kahit ano	Anumang file (binary, text, video, atbp.)	base64

Lahat ng uri ng file ay tinatanggap. Ang uri ay auto-detected at nire-record para sa iyong reference.

Seguridad

Ang mga gateway response ay may kasamang security headers (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) na pumipigil sa mga browser na mag-execute ng mga script sa served na nilalaman.