Skip to content

Identificadors de Contingut (CID)

L'empremta digital unica que rep cada fitxer IPFS.

Que es un CID?

Un Identificador de Contingut (CID) es una etiqueta auto-descriptiva que identifica de manera unica una peca de dades a IPFS. Es deriva del hash criptografic del contingut del fitxer, combinat amb metadata sobre l'algorisme de hash i el format de codificacio utilitzats.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

Els CID que comencen amb Qm utilitzen CIDv0 (SHA-256 codificat en base58). Els CIDv1 mes nous comencen amb bafy i suporten multiples funcions hash i codificacions.

Propietats clau

  • Deterministic — El mateix fitxer sempre produeix el mateix CID.
  • Unic — Fins i tot un canvi d'un byte produeix un CID completament diferent.
  • Auto-verificable — Qualsevol que rebi un fitxer pot recalcular el hash i confirmar que coincideix.
  • Immutable — Un CID sempre apunta al mateix contingut.

CID a IPFS.NINJA

Cada fitxer que pugeu retorna un CID en la resposta de l'API. Utilitzeu-lo per:

  • Accedir al fitxer via gateway: ipfs.ninja/ipfs/<CID>
  • Obtenir metadata del fitxer: GET /file/<CID>
  • Referenciar contingut on-chain (NFT, smart contracts)
  • Compartir amb qualsevol — poden verificar que el contingut coincideix

CIDv0 vs CIDv1

PropietatCIDv0CIDv1
PrefixQm...bafy...
Funcio hashNomes SHA-256Multiples (SHA-256, Blake2b, etc.)
CodificacioBase58Multibase (base32, base58, etc.)
Auto-descriptiuNoSi (inclou info de codec + hash)