Референца API-ја

Све крајње тачке, параметри, формати захтева/одговора и кодови грешака.

Основни URL

https://api.ipfs.ninja

Сви захтеви захтевају API кључ преко заглавља X-Api-Key. Погледајте Аутентификација за детаље.

Крајње тачке

Метод	Путања	Опис	Страница
POST	/upload/new	Отпремање фајла на IPFS	Фајлови
GET	/upload/list	Листа отпремљених фајлова	Фајлови
GET	/file/:cid	Преузимање метаподатака фајла по CID	Фајлови
PUT	/files/:cid/name	Преименовање фајла	Фајлови
PUT	/files/:cid/move	Премештање фајла у фолдер	Фолдери
POST	/pin	Качење постојећег CID са IPFS мреже (подржава наговештаје за swarm-connect)	Качење
GET	/pin/:cid	Провера статуса качења	Качење
POST	/folders	Креирање фолдера	Фолдери
GET	/folders	Листа фолдера	Фолдери
PUT	/folders/:folderId	Ажурирање фолдера	Фолдери
DELETE	/folders/:folderId	Брисање фолдера	Фолдери
POST	/folders/:folderId/snapshot	Снимак фолдера у CID директоријума	Фолдери
PUT	/folders/:folderId/cors	Постављање CORS конфигурације по bucket-у	Фолдери
GET	/folders/:folderId/cors	Преузимање CORS конфигурације по bucket-у	Фолдери
DELETE	/folders/:folderId/cors	Уклањање CORS конфигурације по bucket-у	Фолдери
GET	/user/profile	Преузимање корисничког профила	Профил
POST	/apikeys	Креирање API кључа	API кључеви
GET	/apikeys	Листа API кључева	API кључеви
DELETE	/apikeys/:key	Брисање API кључа	API кључеви
GET	/analytics	Аналитика коришћења	Аналитика
PUT	/gateway-settings	Ажурирање подешавања gateway-а	Gateway-и
POST	/gateway-tokens	Креирање токена gateway-а	Gateway-и
GET	/gateway-tokens	Листа токена gateway-а	Gateway-и
DELETE	/gateway-tokens/:prefix	Брисање токена gateway-а	Gateway-и
POST	/upload/signed-url	Генерисање потписаног токена за отпремање	Потписани токени
GET	/signed-tokens	Листа потписаних токена	Потписани токени
DELETE	/signed-tokens/:tokenId	Опозив потписаног токена	Потписани токени
GET	/image/:cid	Оптимизација слике у ходу	Оптимизација слика

CIDv1 подразумевано

Отпремања и качења враћају модерни CIDv1 (bafk… за мали садржај у једном блоку, bafy… за веће фајлове и директоријуме) у складу са профилом IPIP-0499 unixfs-v1-2025. Стари Qm… CID-ови са ранијих отпремања остају потпуно разрешиви свуда — Qm… је важећи улаз за сваку крајњу тачку која прихвата CID.

S3-компатибилни API

Користите било који AWS SDK за отпремање и управљање фајловима на IPFS Ninja. Усмерите свог S3 клијента на https://s3.ipfs.ninja са својим API кључем као акредитивима.

https://s3.ipfs.ninja

S3 операција	Опис
PutObject	Отпремање фајла на IPFS
GetObject	Преузимање фајла
HeadObject	Преузимање метаподатака фајла
DeleteObject	Откачивање и брисање фајла
ListObjectsV2	Листа фајлова са филтрирањем по префиксу
CreateMultipartUpload	Покретање вишеделног отпремања (до 5 GB)
UploadPart	Отпремање дела
CompleteMultipartUpload	Завршетак вишеделног отпремања
ListBuckets	Листа ваших gateway-а
CreateBucket	Креирање gateway-а (имена bucket-а су глобално јединствена — враћа BucketAlreadyExists ако је заузето)
DeleteBucket	Брисање gateway-а
PutBucketCors	Конфигурисање CORS правила по bucket-у (потребно за коришћење browser SDK-а)
GetBucketCors	Читање тренутне CORS конфигурације за bucket
DeleteBucketCors	Уклањање свих CORS правила из bucket-а

Погледајте S3 компатибилност за пуну документацију, примере кода и водиче за миграцију.