Prikvačivanje

Prikvačite postojeći IPFS sadržaj na svoj račun. Kada prikvačite CID, naš klaster dohvaća sadržaj s IPFS mreže i trajno ga održava dostupnim.

Prikvačivanje prema CID-u

POST /pin

Parametar	Tip	Obavezno	Opis
cid	string	Da	IPFS identifikator sadržaja (počinje s Qm ili bafy).
description	string	Ne	Kratki opis za vašu referencu.
metadata	object	Ne	Prilagođeni parovi ključ-vrijednost za prilaganje prikvačenju. Maks. 10 ključeva. Ključevi moraju biti alfanumerički ili podvlaka, 1-64 znaka. Vrijednosti moraju biti nizovi znakova, maks. 256 znakova. Ukupna veličina metapodataka ne smije premašiti 4 KB.

Primjer zahtjeva

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

Prikvačivanje je asinkrono. Odgovor se vraća odmah sa statusom pinning. Za provjeru završetka prikvačivanja provjeravajte endpoint statusa.

Provjera statusa prikvačivanja

GET /pin/:cid

Parametar	Tip	Obavezno	Opis
cid	string	Da	CID koji provjeravate.

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"
  }
}

Vrijednosti statusa

Status
pinning	Sadržaj se dohvaća s IPFS mreže. Provjerite ponovo za nekoliko sekundi.
pinned	Sadržaj je prikvačen i dostupan putem vašeg računa i gatewaya.
failed	Sadržaj nije pronađen na IPFS mreži. CID može biti nevažeći ili sadržaj više nije dostupan.

Kako prikvačivanje radi

1. Pošaljete CID putem POST /pin
2. Naš IPFS klaster pretražuje mrežu tražeći čvorove koji imaju sadržaj
3. Klaster preuzima i prikvačuje sadržaj lokalno
4. Jednom prikvačena, datoteka se pojavljuje u vašem popisu datoteka i dostupna je putem gatewaya
5. Korištenje pohrane bilježi se po završetku prikvačivanja

WARNING

Vrijeme prikvačivanja ovisi o veličini datoteke i dostupnosti mreže. Male datoteke se obično prikvače u sekundama. Velike datoteke ili rijetko prikvačeni sadržaj može trajati minutama.

Pohrana

Prikvačeni sadržaj ubraja se u limit pohrane vašeg plana. Veličina datoteke bilježi se po završetku prikvačivanja — možete pokrenuti prikvačivanje čak i ako je vaša pohrana blizu limita, ali daljnji prijenosi bit će blokirani ako prikvačivanje uzrokuje prekoračenje.