Fästning

Fäst befintligt IPFS-innehåll till ditt konto. När du fäster en CID hämtar vårt kluster innehållet från IPFS-nätverket och håller det permanent tillgängligt.

Fäst via CID

POST /pin

Parameter	Typ	Obligatorisk	Beskrivning
cid	string	Ja	IPFS-innehållsidentifierare (börjar med Qm eller bafy).
description	string	Nej	Kort beskrivning för din referens.
metadata	object	Nej	Anpassade nyckel-värde-par att bifoga fästningen. Max 10 nycklar. Nycklar måste vara alfanumeriska eller understreck, 1-64 tecken. Värden måste vara strängar, max 256 tecken vardera. Total metadatastorlek får inte överstiga 4 KB.

Exempelbegäran

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

Svar 202 Accepted

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

TIP

Fästning är asynkron. Svaret returneras omedelbart med status pinning. Polla statusendpointen för att kontrollera när fästningen är klar.

Kontrollera fästningsstatus

GET /pin/:cid

Parameter	Typ	Obligatorisk	Beskrivning
cid	string	Ja	CID:n du kontrollerar.

Svar 200 OK

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

Statusvärden

Status	Betydelse
pinning	Innehåll hämtas från IPFS-nätverket. Polla igen om några sekunder.
pinned	Innehållet är fäst och tillgängligt via ditt konto och gateway.
failed	Innehållet kunde inte hittas på IPFS-nätverket. CID:n kan vara ogiltig eller innehållet är inte längre tillgängligt.

Hur fästning fungerar

1. Du skickar en CID via POST /pin
2. Vårt IPFS-kluster söker i nätverket efter noder som har innehållet
3. Klustret laddar ner och fäster innehållet lokalt
4. När det är fäst visas filen i din fillista och är åtkomlig via gatewayen
5. Lagringsanvändning registreras när fästningen slutförs

WARNING

Fästningstiden beror på filstorlek och nätverkstillgänglighet. Små filer fästs vanligtvis på sekunder. Stora filer eller sällan fäst innehåll kan ta minuter.

Lagring

Fäst innehåll räknas mot din plans lagringsgräns. Filstorleken registreras när fästningen slutförs — du kan initiera en fästning även om ditt lagringsutrymme är nära gränsen, men ytterligare uppladdningar blockeras om fästningen gör att du överskrider den.