Καρφίτσωμα

Καρφιτσώστε υπάρχον περιεχόμενο IPFS στον λογαριασμό σας. Όταν καρφιτσώνετε ένα CID, το cluster μας ανακτά το περιεχόμενο από το δίκτυο IPFS και το κρατά μόνιμα διαθέσιμο.

Καρφίτσωμα με CID

POST /pin

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
cid	string	Ναι	Αναγνωριστικό περιεχομένου IPFS (ξεκινά με Qm ή bafy).
description	string	Όχι	Σύντομη περιγραφή.
metadata	object	Όχι	Προσαρμοσμένα ζεύγη κλειδιού-τιμής. Μέγιστο 10 κλειδιά.

Παράδειγμα αιτήματος

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

Απάντηση 202 Accepted

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

TIP

Το καρφίτσωμα είναι ασύγχρονο. Η απάντηση επιστρέφει αμέσως με κατάσταση pinning. Κάντε poll στο endpoint κατάστασης.

Έλεγχος Κατάστασης

GET /pin/:cid

Τιμές κατάστασης

Κατάσταση	Σημασία
pinning	Ανάκτηση περιεχομένου από το δίκτυο IPFS.
pinned	Καρφιτσωμένο και διαθέσιμο.
failed	Δεν βρέθηκε το περιεχόμενο στο δίκτυο IPFS.