Skip to content

Pengecam Kandungan (CID)

Cap jari unik yang diterima setiap fail IPFS.

Apa itu CID?

Pengecam Kandungan (CID) ialah label yang mendeskripsikan diri sendiri yang mengenal pasti sekeping data pada IPFS secara unik. Ia diperoleh daripada hash kriptografi kandungan fail, digabungkan dengan metadata tentang algoritma hash dan format pengekodan yang digunakan.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

CID yang bermula dengan Qm menggunakan CIDv0 (SHA-256 berkod base58). CIDv1 yang lebih baharu bermula dengan bafy dan menyokong pelbagai fungsi hash dan pengekodan.

Sifat utama

  • Deterministik — Fail yang sama sentiasa menghasilkan CID yang sama. Muat naik imej yang sama dua kali dan anda mendapat pengecam yang sama.
  • Unik — Perubahan satu bait pun menghasilkan CID yang berbeza sepenuhnya. Ini menjadikan CID bukti gangguan.
  • Pengesahan kendiri — Sesiapa yang menerima fail boleh mengira semula hash dan mengesahkan ia sepadan dengan CID yang diminta.
  • Tidak boleh diubah — CID sentiasa menunjuk kepada kandungan yang sama. Anda tidak boleh menukar apa yang diselesaikan oleh CID.

CID dalam IPFS.NINJA

Setiap fail yang anda muat naik mengembalikan CID dalam respons API. Gunakannya untuk:

  • Mengakses fail melalui gateway: ipfs.ninja/ipfs/<CID>
  • Mendapatkan metadata fail: GET /file/<CID>
  • Merujuk kandungan on-chain (NFT, smart contract)
  • Berkongsi dengan sesiapa — mereka boleh mengesahkan kandungan sepadan

CIDv0 vs CIDv1

SifatCIDv0CIDv1
PrefixQm...bafy...
Fungsi hashSHA-256 sahajaPelbagai (SHA-256, Blake2b, dll.)
PengekodanBase58Multibase (base32, base58, dll.)
Mendeskripsikan diriTidakYa (termasuk maklumat codec + hash)