GET /dataset/{schema_name}

Ambil dokumen yang dipublikasikan untuk sebuah skema — semuanya, satu, sekumpulan, atau satu halaman — sebagai array JSON yang dialirkan.

Ambil dokumen yang dipublikasikan untuk sebuah skema — semuanya, satu dokumen, sekumpulan berdasarkan ID, atau satu halaman — dialirkan sebagai array JSON. Juga tersedia di /schemas/{schema_name}. Referensi gambar diselesaikan menjadi URL, dan ketika language diatur, terjemahan yang cocok digabungkan di atas konten dasar.

Auth: Kunci API. Sebuah kunci hanya diperlukan ketika server menetapkan require_schema_api_key = true; jika tidak, pembacaan anonim diperbolehkan.

Parameter path

Parameter	Jenis	Wajib	Catatan
`schema_name`	string	ya	Skema dokumen, mis. `post`.

Parameter kueri

Parameter	Jenis	Wajib	Catatan
`websiteId`	uuid	tidak	Situs web target; kembali ke header / konfigurasi `Host`.
`id`	uuid	tidak	Ambil satu dokumen. Mengungguli `ids`.
`ids`	string	tidak	UUID yang dipisahkan koma (batch, maks 200). Mengungguli paginasi.
`language`	string	tidak	Gabungkan terjemahan untuk lokal ini di atas konten dasar.
`limit`	integer	tidak	Ukuran halaman, bawaan `200`, dibatasi hingga `200`.
`offset`	integer	tidak	Jumlah baris untuk dilewati (hanya diterapkan dengan limit positif).
`api_key`	string	tidak	Alternatif untuk header `x-api-key`.

Ketika id maupun ids tidak diatur, dokumen dikembalikan dengan urutan published_at DESC.

Respons

Sebuah array JSON yang dialirkan. Setiap elemen adalah konten terbit dokumen yang diratakan di tingkat teratas, ditambah kunci yang disuntikkan _id, _title, dan _publishedAt:

[
  {
    "_id": "...",
    "_title": "Memulai",
    "_publishedAt": "2026-06-23T20:36:31Z",
    "title": "Memulai",
    "description": "...",
    "content": "..."
  }
]

Kolom konten memenangkan atas kunci yang disuntikkan saat terjadi tabrakan. Referensi gambar dengan bentuk { alt, _asset: { id } } mendapatkan url yang diselesaikan dan disuntikkan ke _asset.

Contoh

curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
  -H 'x-api-key: <key>'

Kesalahan

400 — websiteId tidak valid, id tidak valid, atau ids buruk (kosong, lebih dari 200, atau UUID tidak valid)
401 — kunci API tidak valid (atau hilang ketika diperlukan)
500 — kueri gagal

Previous‹GET /components/{name}NextGET /content-changes (SSE)›