IPFS Ninja

Лесно качвайте изображения, PDF файлове и JSON файлове в IPFS и получете постоянен идентификатор на съдържанието (CID) с незабавен достъп през gateway.

Какво е IPFS?

InterPlanetary File System (IPFS) е децентрализиран peer-to-peer протокол за съхранение. IPFS разделя файловете на по-малки части, разпределя ги в мрежата и присвоява на всеки файл уникален идентификатор на съдържанието (CID) въз основа на неговото съдържание.

Това означава:

• Разпределено съхранение — вашите файлове се съхраняват в множество възли за подобрена надеждност.
• Адресиране по съдържание — CID се извлича от самото съдържание на файла, което гарантира неизменност.
• Достъпност в цялата мрежа — всеки, който разполага с CID, може да извлече файла от който и да е IPFS възел.

Какво прави IPFS Ninja

IPFS Ninja е управлявана услуга, която ви позволява да качвате файлове и да закачате съществуващо съдържание в IPFS чрез прост REST API. Не е необходимо да управлявате собствен IPFS възел.

• Качване на нови файлове — изпратете произволен файл чрез POST /upload/new и получете постоянен CID
• Закачане на съществуващи CID — вече имате съдържание в IPFS? Закачете го към нашия клъстер чрез POST /pin, за да остане достъпно
• Достъп чрез gateway — цялото закачено съдържание е достъпно на ipfs.ninja/ipfs/<CID>
• Потребителски метаданни — прикачете двойки ключ-стойност към качванията и закаченията за организация и филтриране
• Подписани токени за качване — генерирайте токени с ограничен срок за качвания от страна на клиента без разкриване на вашия API ключ
• IPNS променливи имена — създавайте стабилни имена, които сочат към променящи се CID чрез IPNS API, до 10 имена на акаунт
• Оптимизация на изображения — преоразмерявайте, конвертирайте и компресирайте изображения в движение чрез параметри на URL на gateway

Табло за управление

Проследявайте качванията, съхранението и честотната лента на gateway от вашето лично табло за управление.

Достъп чрез gateway

Всеки качен файл е достъпен чрез IPFS Ninja gateway, който действа като мост между децентрализираната IPFS мрежа и традиционните уеб браузъри.

URL на gateway следва този модел:

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

TIP

Вашите файлове са достъпни и от всеки публичен IPFS gateway (напр. dweb.link, w3s.link) със същия CID — IPFS мрежата е децентрализирана.

Потребителите на плана Nirvana получават специализиран gateway на собствен поддомейн (<slug>.gw.ipfs.ninja), който обслужва само файлове, закачени към техния акаунт — с опционален контрол на достъпа на базата на токени и ограничения по произход.

Поддържани типове файлове

Тип	Формати	Вход
JSON	Всеки валиден JSON обект или масив	string / object
Изображения	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Стандартни PDF документи	base64
HTML	HTML документи	base64
Всякакъв	Всеки файл (двоичен, текстов, видео и др.)	base64

Всички типове файлове се приемат. Типът се разпознава автоматично и се записва за ваша справка.

Сигурност

Отговорите на gateway включват заглавия за сигурност (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY), които предотвратяват изпълнението на скриптове от браузърите в обслужваното съдържание.

Ограничения на размера

Ограничение	Стойност
Макс. размер на заявка	6 MB (лимит на API Gateway)
Общо съхранение (Dharma)	1 GB
Общо съхранение (Bodhi)	10 GB
Общо съхранение (Nirvana)	100 GB

Случаи на употреба

NFT метаданни и активи

Съхранявайте NFT метаданни JSON и свързани изображения с постоянни, неизменни CID.

Хостинг на статични ресурси

Хоствайте изображения, документи и файлове с данни за уеб и мобилни приложения.

Проверимо споделяне на данни

Споделяйте данни с доказуем произход, базиран на съдържание — получателите могат да проверят, че нищо не е променено.