Skip to content

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

ParameterTypObligatoriskBeskrivning
cidstringJaIPFS-innehållsidentifierare (börjar med Qm eller bafy).
descriptionstringNejKort beskrivning för din referens.
metadataobjectNejAnpassade 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

bash
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

json
{
  "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

ParameterTypObligatoriskBeskrivning
cidstringJaCID:n du kontrollerar.

Svar 200 OK

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

Statusvärden

StatusBetydelse
pinningInnehåll hämtas från IPFS-nätverket. Polla igen om några sekunder.
pinnedInnehållet är fäst och tillgängligt via ditt konto och gateway.
failedInnehå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.