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

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

Проследявайте качванията, съхранението и честотната лента на gateway от вашето лично табло за управление. Таблото за управление ви позволява също да управлявате по-голямата част от API без да пишете код:

• Качване чрез плъзгане и пускане — файлове, папки (пакетирани в UnixFS директория във вашия браузър) или .car архиви
• Преименуване на файлове след качване; описанието се попълва автоматично от името на файла при избор
• Снимка на папка, за да получите един CID на директория за всичко вътре в нея
• Конфигуриране на S3 CORS за отделен bucket чрез редактор с форма (за интеграции със SDK в браузъра)
• Управление на API ключове, gateway токени, IPNS имена и настройки на специализиран gateway

Достъп чрез gateway

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