Şema kataloğu

Belge türü kataloğu — her `vct` için tür metadatası ve JSON Schema. Statik, herkese açık, kimlik doğrulama yok.

Katalog (gerçek ağ ve sandbox ortak)

https://schemas.tamga.network/v1

Kimlik doğrulama

Yok — herkese açık

Tanım

OpenAPI 3.1 dosyası · Rehber

Her Tamga belge türünün bir URN'si vardır (vct, ör. urn:tamga:edu:DiplomaCredential:1). Katalog her vct'yi SD-JWT VC Type Metadata'sına ve JSON Schema'sına bağlar (IETF SD-JWT VC kayıt çözümlemesi). Belge vct#integrity taşır; metadataya güvenmeden önce bunu katalog kaydındaki content_hash ile karşılaştırın. Dosyalar yol ile sürümlenir ve yayınlandıktan sonra değişmez; güven listeleri her şemanın özetini çapalar.

Aynı katalog çevrim dışı kullanım için @tamga-network/schemas paketindedir. Kurallar SPEC-SCHEMA-0001'de.

Uç noktalar

Uç nokta	Açıklama
GET /catalogue.json	Kataloğu al
GET /index.json	Düz dizini al
GET /{domain}/{type}/{version}/metadata.json	Bir türün metadatasını al
GET /{domain}/{type}/{version}/schema.json	Bir türün JSON Schema'sını al

Kimlik doğrulama

Kimlik doğrulama yok: bütün uçlar herkese açık.

Katalog

Bir belge türünü ve dosyalarını bulun.

Kataloğu al

GET/catalogue.json

Her belge türü; metadata ve şema adresleri, özetleri ve durumuyla.

Kimlik doğrulama Yok — herkese açık

Yanıtlar

Durum	Açıklama
200	Katalog.

Örnek

İstek · curl

curl "https://schemas.tamga.network/v1/catalogue.json"

Yanıt · 200

{
  "catalogue_version": 0,
  "generated_at": "2026-10-09T12:00:00Z",
  "base": "https://example.org",
  "entries": [
    {
      "vct": "urn:tamga:edu:StudentCredential:1",
      "schema_id": "…",
      "metadata_url": "https://example.org",
      "schema_url": "https://example.org",
      "content_hash": "…",
      "content_hashes": [
        "…"
      ],
      "version": "1.0.0",
      "layer": "NETWORK",
      "status": "ACTIVE"
    }
  ]
}

Düz dizini al

GET/index.json

Katalog kayıtları, zarfsız düz dizi olarak.

Kimlik doğrulama Yok — herkese açık

Yanıtlar

Durum	Açıklama
200	Kayıtlar. Döner: CatalogueEntry

Örnek

İstek · curl

curl "https://schemas.tamga.network/v1/index.json"

Yanıt · 200

[
  {
    "vct": "urn:tamga:edu:StudentCredential:1",
    "schema_id": "…",
    "metadata_url": "https://example.org",
    "schema_url": "https://example.org",
    "content_hash": "…",
    "content_hashes": [
      "…"
    ],
    "version": "1.0.0",
    "layer": "NETWORK",
    "status": "ACTIVE"
  }
]

Bir türün metadatasını al

GET/{domain}/{type}/{version}/metadata.json

SD-JWT VC Type Metadata: her dilde görünen adlar, üst tür (extends + extends#integrity), schema_uri#integrity ile şema adresi ve alan gösterim kuralları. Yolu kendiniz kurmak yerine katalogdaki metadata_url değerini kullanın.

Kimlik doğrulama Yok — herkese açık

Parametreler

Ad	Yer	Tür	Açıklama
domain zorunlu	yol	string
type zorunlu	yol	string
version zorunlu	yol	string

Yanıtlar

Durum	Açıklama
200	Type Metadata.
404	Bilinmeyen tür ya da sürüm.

Örnek

İstek · curl

curl "https://schemas.tamga.network/v1/edu/StudentCredential/1.0.0/metadata.json"

Yanıt · 200

{
  "vct": "urn:tamga:edu:StudentCredential:1",
  "version": "1.0.0",
  "name": "Tamga Student Credential",
  "extends": "urn:tamga:core:TamgaBaseCredential:1",
  "schema_uri": "https://schemas.tamga.network/v1/edu/StudentCredential/1.0.0/schema.json",
  "display": [
    {
      "lang": "tr-TR",
      "name": "Öğrenci Belgesi"
    },
    {
      "lang": "en-US",
      "name": "Student Certificate"
    }
  ]
}

Bir türün JSON Schema'sını al

GET/{domain}/{type}/{version}/schema.json

Belge alanlarının JSON Schema'sı (katalogdaki schema_url değerini kullanın).

Kimlik doğrulama Yok — herkese açık

Parametreler

Ad	Yer	Tür	Açıklama
domain zorunlu	yol	string
type zorunlu	yol	string
version zorunlu	yol	string

Yanıtlar

Durum	Açıklama
200	JSON Schema.
404	Bilinmeyen tür ya da sürüm.

Örnek

İstek · curl

curl "https://schemas.tamga.network/v1/edu/StudentCredential/1.0.0/schema.json"

Yanıt · 200

{}

Nesneler

CatalogueEntry

Alan	Tür	Açıklama
vct	string
schema_id	string	keccak256(vct)
metadata_url	string (uri)
schema_url	string (uri)
content_hash	string	Güncel metadatanın özeti — belgedeki vct#integrity ile eşittir.
content_hashes	array<string>	Geçerli sürümlerin özetleri.
version	string
layer	string	Değerler: NETWORK · NATIONAL
status	string

---

Makine okur tanımı herhangi bir OpenAPI aracına aktararak istemci üretebilir ya da deneme isteği gönderebilirsiniz: schema-catalogue.openapi.yaml.