Yayınlanmış belgeleri bir şema için — tamamını, birini, bir toplu kümeyi veya bir sayfayı — akış halinde bir JSON dizisi olarak getirir.
Yayınlanmış belgeleri bir şema için — tamamını, tek bir belgeyi, kimliklere göre bir toplu kümeyi veya bir sayfayı — JSON dizisi olarak akış halinde getirir. /schemas/{schema_name} adresinde de kullanılabilir. Görsel referansları URL'lere dönüştürülür ve language ayarlandığında ilgili çeviri temel içeriğin üzerine birleştirilir.
Kimlik Doğrulama: API anahtarı. Sunucu require_schema_api_key = true olarak ayarladığında anahtar gereklidir; aksi halde anonim okumaya izin verilir.
| Parametre | Tür | Gerekli | Notlar |
|---|---|---|---|
schema_name | string | evet | Belge şeması, örn. post. |
| Parametre | Tür | Gerekli | Notlar |
|---|---|---|---|
websiteId | uuid | hayır | Hedef web sitesi; varsayılan olarak Host üst bilgisi / yapılandırması kullanılır. |
id | uuid | hayır | Tek bir belge getirir. ids üzerinde önceliklidir. |
ids | string | hayır | Virgülle ayrılmış UUID'ler (toplu, en fazla 200). Sayfalamaya göre önceliklidir. |
language | string | hayır | Bu yerel ayara ait çeviriyi temel içeriğin üzerine birleştirir. |
limit | integer | hayır | Sayfa boyutu, varsayılan 200, üst sınır 200. |
offset | integer | hayır | Atlanacak satır sayısı (yalnızca pozitif bir limit ile uygulanır). |
api_key | string | hayır | x-api-key üst bilgisine alternatif. |
Ne id ne de ids ayarlandığında, belgeler published_at DESC sırasına göre döndürülür.
Akış halinde bir JSON dizisi. Her öğe, belgenin yayımlanmış içeriğinin üst düzeyde açılmış halidir ve _id, _title ve _publishedAt anahtarları eklenmiştir:
[
{
"_id": "...",
"_title": "Başlarken",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Başlarken",
"description": "...",
"content": "..."
}
]
İçerik alanları çakışma durumunda eklenen anahtarların önüne geçer. { alt, _asset: { id } } biçimindeki görsel referanslarına _asset içine çözümlenmiş bir url eklenir.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — geçersiz websiteId, geçersiz id veya hatalı ids (boş, 200'den fazla veya geçersiz bir UUID)401 — geçersiz API anahtarı (veya gerekli olduğunda eksik)500 — sorgu hatası