IPFS Ninja

Легко загружайте изображения, PDF-файлы и JSON-файлы в IPFS и получайте постоянный идентификатор содержимого (CID) с мгновенным доступом через шлюз.

Что такое IPFS?

Межпланетная файловая система (IPFS) — это децентрализованный одноранговый протокол хранения данных. IPFS разбивает файлы на более мелкие фрагменты, распределяет их по сети и присваивает каждому файлу уникальный идентификатор содержимого (CID) на основе его содержимого.

Это означает:

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

Что делает IPFS Ninja

IPFS Ninja — это управляемый сервис, который позволяет загружать файлы и закреплять существующий контент в IPFS через простой REST API. Не нужно запускать собственный узел IPFS.

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

Панель управления

Отслеживайте загрузки, хранилище и пропускную способность шлюза в вашей персональной панели управления.

Доступ через шлюз

Каждый загруженный файл доступен через шлюз IPFS Ninja, который служит мостом между децентрализованной сетью IPFS и обычными веб-браузерами.

URL шлюза следует этому шаблону:

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

TIP

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

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

Поддерживаемые типы файлов

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

Принимаются все типы файлов. Тип определяется автоматически и сохраняется для вашего удобства.

Безопасность

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

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

Ограничение	Значение
Макс. размер запроса	6 МБ (ограничение API Gateway)
Общее хранилище (Dharma)	1 ГБ
Общее хранилище (Bodhi)	10 ГБ
Общее хранилище (Nirvana)	100 ГБ

Примеры использования

Метаданные и ресурсы NFT

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

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

Размещайте изображения, документы и файлы данных для веб- и мобильных приложений.

Верифицируемый обмен данными

Делитесь данными с подтверждением происхождения на основе содержимого — получатели могут убедиться, что данные не были изменены.