Metaobject'ler

PUT /custom-data/metaobjects/{type}/entries/{handle} — scope (yetki) write_metaobjects.

Metaobject, tüccarın yönetim panelinde (Ayarlar → Özel veriler) tanımladığı bir türün kaydıdır: bir “ikinci el araç”, bir “mağaza etkinliği”, bir “beden tablosu”. Uygulamanız o türün kayıtlarını doldurur; mağazanın teması da bunları görüntüler. Zugo uygulaması araç ilanlarını bu yolla yayımlar.

Handle ile upsert

PUT, {type} içinde {handle} yoksa kaydı oluşturur, varsa tamamen değiştirir. Handle’ları kendi kararlı id’lerinizden türetin — aynı kaynak kayıt her zaman aynı kayda eşlenir, böylece bir senkronizasyonu yeniden çalıştırmak kopya üretmez, günceller.

PUT /custom-data/metaobjects/ikinci-el-arac/entries/zugo-48213
Content-Type: application/json

{
  "fields": {
    "marka": "Renault",
    "yil": 2021,
    "gorseller": ["<mediaAssetId>", "<mediaAssetId>"]
  },
  "publishedAt": "2026-09-22T09:00:00+00:00",
  "seoTitle": "2021 Renault Clio",
  "translations": { "en": { "marka": "Renault" } }
}

Alan	Anlamı
`fields`	Türün alan anahtarlarıyla anahtarlanmış nesne; değerler, alan türünün kabul ettiği herhangi bir JSON olabilir.
`publishedAt`	Kaydın görünür olacağı zaman. Yalnızca yayımlanabilir olarak işaretlenmiş türler için; aksi halde `400`.
`seoTitle`, `seoDescription`	En fazla sırasıyla 256 ve 512 karakter.
`translations`	`{ locale: { fieldKey: text } }`.

Handle’lar küçük harf, rakam, - ve _ içerebilir; en fazla 128 karakterdir.

Yanıtlar

Durum	Anlamı
`200`	`{ "id", "handle", "publishedAt", "seoTitle", "seoDescription" }`
`400`	Doğrulama hatası — geçersiz handle, türün tanımlamadığı bir alan anahtarı, alan türünün reddettiği bir değer, var olmayan bir kayda referans ya da sınırını aşan bir metin.
`404`	Bu mağazada `{type}` adında bir metaobject türü yok. Tüccarın önce onu oluşturması gerekir.

Alan anahtarları ve türleri platformdan değil, tüccarın tür tanımından gelir. Geliştirmeye başlamadan önce bunlar üzerinde mağazayla anlaşın — uygulamanız ile tema arasındaki sözleşme bunlardır.

Bu endpoint Idempotency-Key almaz; ihtiyacı da yoktur, çünkü aynı PUT’u tekrarlamak aynı kaydı üretir.