Sabitleme

Mevcut IPFS içeriğini hesabınıza sabitleyin. Bir CID'yi sabitlediğinizde, kümemiz içeriği IPFS ağından alır ve kalıcı olarak erişilebilir tutar.

CID ile Sabitle

POST /pin

Parametre	Tür	Zorunlu	Açıklama
cid	string	Evet	IPFS içerik tanımlayıcısı (Qm veya bafy ile başlar).
description	string	Hayır	Referansınız için kısa açıklama.
metadata	object	Hayır	Sabitlemeye eklenecek özel anahtar-değer çiftleri. Maksimum 10 anahtar. Anahtarlar alfanumerik veya alt çizgi olmalıdır, 1-64 karakter. Değerler dize olmalıdır, her biri maksimum 256 karakter. Toplam meta veri boyutu 4 KB'yi aşmamalıdır.

Örnek istek

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

Yanıt 202 Accepted

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

TIP

Sabitleme eşzamansızdır. Yanıt pinning durumuyla hemen döner. Sabitlemenin ne zaman tamamlanacağını kontrol etmek için durum uç noktasını sorgulayın.

Sabitleme Durumunu Kontrol Et

GET /pin/:cid

Parametre	Tür	Zorunlu	Açıklama
cid	string	Evet	Kontrol ettiğiniz CID.

Yanıt 200 OK

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

Durum değerleri

Durum	Anlamı
pinning	İçerik IPFS ağından alınıyor. Birkaç saniye sonra tekrar sorgulayın.
pinned	İçerik sabitlendi ve hesabınız ile gateway üzerinden erişilebilir.
failed	İçerik IPFS ağında bulunamadı. CID geçersiz olabilir veya içerik artık mevcut değil.

Sabitleme nasıl çalışır

1. POST /pin ile bir CID gönderirsiniz
2. IPFS kümemiz, içeriğe sahip düğümler için ağı arar
3. Küme içeriği indirir ve yerel olarak sabitler
4. Sabitlendiğinde, dosya dosya listenizde görünür ve gateway üzerinden erişilebilir olur
5. Depolama kullanımı sabitleme tamamlandığında kaydedilir

WARNING

Sabitleme süresi dosya boyutuna ve ağ erişilebilirliğine bağlıdır. Küçük dosyalar genellikle saniyeler içinde sabitlenir. Büyük dosyalar veya nadiren sabitlenmiş içerik dakikalar alabilir.

Depolama

Sabitlenmiş içerik planınızın depolama sınırına dahildir. Dosya boyutu sabitleme tamamlandığında kaydedilir — depolama alanınız sınıra yakın olsa bile sabitleme başlatabilirsiniz, ancak sabitleme sınırı aşmanıza neden olursa sonraki yüklemeler engellenir.