IPFS Ninja

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

Що таке IPFS?

InterPlanetary File System (IPFS) — це децентралізований протокол зберігання з однорангового обміну. 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 key
• Змінювані імена IPNS — створюйте стабільні імена, що вказують на змінювані CID через API IPNS, до 10 імен на акаунт
• Оптимізація зображень — змінюйте розмір, конвертуйте та стискайте зображення на льоту через параметри URL gateway

Dashboard

Відстежуйте завантаження, сховище та пропускну здатність gateway з вашої персональної dashboard.

Доступ до gateway

Кожен завантажений файл доступний через gateway IPFS Ninja, який виступає мостом між децентралізованою мережею 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), які запобігають виконанню браузерами скриптів у наданому контенті.

Обмеження розміру

Обмеження	Значення
Макс. payload на запит	6 MB (ліміт API Gateway)
Загальне сховище (Dharma)	1 GB
Загальне сховище (Bodhi)	10 GB
Загальне сховище (Nirvana)	100 GB

Випадки використання

Метадані та активи NFT

Зберігайте метадані JSON NFT та пов'язані зображення з постійними, незмінними CID.

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

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

Верифіковане обмін даними

Діліться даними з адресацією за вмістом — отримувачі можуть перевірити, що нічого не було підроблено.