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> (apex-шлюз обслуговує лише CID з вашого облікового запису або з інших облікових записів IPFS Ninja — див. Доступ до шлюзу нижче)
• Користувацькі метадані — додавайте пари ключ-значення до завантажень та пінів для організації та фільтрації
• Підписані токени завантаження — генеруйте токени з обмеженим терміном для завантажень на стороні клієнта без розкриття вашого API key
• Змінювані імена IPNS — створюйте стабільні імена, що вказують на змінювані CID через API IPNS, до 10 імен на акаунт
• Оптимізація зображень — змінюйте розмір, конвертуйте та стискайте зображення на льоту через параметри URL gateway

Dashboard

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

• Завантаження drag-and-drop — файли, папки (запаковуються в директорію UnixFS у вашому браузері) або архіви .car
• Перейменування файлів після завантаження; опис автоматично заповнюється з імені файлу під час вибору
• Знімок (snapshot) папки для отримання одного directory CID для всього вмісту
• Налаштування S3 CORS для окремого bucket'а через редактор на основі форми (для інтеграцій з браузерним SDK)
• Керування API-ключами, токенами gateway, іменами IPNS та налаштуваннями виділеного gateway

Доступ до gateway

Кожен завантажений файл доступний через gateway IPFS Ninja, який виступає мостом між децентралізованою мережею IPFS та традиційними веб-браузерами.

URL gateway має такий формат:

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

Область дії apex-шлюзу

Apex-шлюз за адресою https://ipfs.ninja/ipfs/<CID> обслуговує лише CID, які були завантажені або закріплені зареєстрованим користувачем IPFS Ninja. Запити для будь-яких інших CID повертають HTTP 410 Gone з вказівником на публічні IPFS-шлюзи, такі як ipfs.io або dweb.link. Щоб обслуговувати CID третьої сторони через наш шлюз, зареєструйтеся безкоштовно і спочатку виконайте POST /pin для свого облікового запису.

TIP

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

Усі платні плани отримують виділений gateway на власному піддомені (<slug>.gw.ipfs.ninja), який обслуговує тільки файли, закріплені за їхнім акаунтом — з опціональним контролем доступу на основі токенів та обмеженнями джерел. Виділений gateway — рекомендована URL-адреса для продакшн-вбудовування (відео, переглядачі NFT, вебсайти).

Підтримувані типи файлів

Тип	Формати	Вхідні дані
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), які запобігають виконанню браузерами скриптів у наданому контенті.