Качење

Закачите постојећи IPFS садржај на свој налог. Када закачите CID, наш кластер преузима садржај са IPFS мреже и трајно га одржава доступним.

Качење по CID

POST /pin

Параметар	Тип	Обавезно	Опис
cid	string	Да	IPFS идентификатор садржаја (почиње са Qm или bafy).
description	string	Не	Кратак опис за вашу референцу.
metadata	object	Не	Прилагођени парови кључ-вредност за прикачивање. Макс. 10 кључева. Кључеви морају бити алфанумерички или доња црта, 1-64 карактера. Вредности морају бити стрингови, макс. 256 карактера. Укупна величина метаподатака не сме премашити 4 KB.

Пример захтева

curl -X POST https://api.ipfs.ninja/pin \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "cid": "QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F",
    "description": "NFT metadata",
    "metadata": {
      "collection": "my-nfts",
      "token_id": "42"
    }
  }'

Response 202 Accepted

{
  "cid": "QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F",
  "status": "pinning",
  "description": "NFT metadata",
  "uris": {
    "ipfs": "ipfs://QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F",
    "url": "https://ipfs.ninja/ipfs/QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F"
  }
}

TIP

Качење је асинхроно. Одговор се враћа одмах са статусом pinning. За проверу завршетка качења проверавајте крајњу тачку статуса.

Провера статуса качења

GET /pin/:cid

Параметар	Тип	Обавезно	Опис
cid	string	Да	CID који проверавате.

Response 200 OK

{
  "cid": "QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F",
  "status": "pinned",
  "sizeMB": 0.042,
  "fileName": "NFT metadata",
  "pinnedAt": 1711036800000,
  "uris": {
    "ipfs": "ipfs://QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F",
    "url": "https://ipfs.ninja/ipfs/QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F"
  }
}

Вредности статуса

Status
pinning	Садржај се преузима са IPFS мреже. Проверите поново за неколико секунди.
pinned	Садржај је закачен и доступан преко вашег налога и gateway-а.
failed	Садржај није могао бити пронађен на IPFS мрежи. CID може бити неважећи или садржај више није доступан.

Како качење ради

1. Шаљете CID преко POST /pin
2. Наш IPFS кластер претражује мрежу тражећи чворове који имају садржај
3. Кластер преузима и качи садржај локално
4. Једном закачен, фајл се појављује у вашој листи фајлова и доступан је преко gateway-а
5. Коришћење складиштења се бележи по завршетку качења

WARNING

Време качења зависи од величине фајла и доступности мреже. Мали фајлови се типично закаче за секунде. Велики фајлови или ретко качени садржај може трајати минутима.

Складиштење

Закачени садржај се рачуна у ограничење складиштења вашег плана. Величина фајла се бележи по завршетку качења — можете покренути качење чак и ако је ваше складиштење близу ограничења, али даља отпремања ће бити блокирана ако качење узрокује његово премашивање.