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 gateway сервира само CID-ове са вашег налога или из других IPFS Ninja налога — погледајте Приступ преко gateway-а испод)
• Прилагођени метаподаци — прикачите парове кључ-вредност отпремањима и качењима за организацију и филтрирање
• Потписани токени за отпремање — генеришите временски ограничене токене за отпремање на страни клијента без откривања вашег API кључа
• IPNS променљива имена — креирајте стабилна имена која упућују на променљиве CID-ове преко IPNS API-ја, до 10 имена по налогу
• Оптимизација слика — мењајте величину, конвертујте и компримујте слике у ходу помоћу параметара URL-а gateway-а

Контролна табла

Пратите отпремања, складиштење и пропусни опсег gateway-а са ваше личне контролне табле. Контролна табла вам такође омогућава да управљате већином API-ја без писања кода:

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

Приступ преко gateway-а

Сваки отпремљени фајл доступан је преко IPFS Ninja gateway-а, који служи као мост између децентрализоване IPFS мреже и традиционалних веб прегледача.

URL gateway-а прати овај образац:

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

Опсег apex gateway-а

Apex gateway на https://ipfs.ninja/ipfs/<CID> сервира само CID-ове које је отпремио или закачио регистровани корисник IPFS Ninja. Захтеви за било који други CID враћају HTTP 410 Gone са показивачем на јавне IPFS gateway-е попут ipfs.io или dweb.link. Да бисте сервирали CID треће стране преко нашег gateway-а, региструјте се бесплатно и прво извршите 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) која спречавају прегледаче да извршавају скрипте у сервираном садржају.