Referensi API Kontena

Halaman ini menyajikan REST API publik Kontena. Sumber kebenaran adalah spec OpenAPI Worker (services/kontena/src/openapi.json di repo sawala-cloud-core).

:::note Prototype note Embed Scalar di bawah dimuat via web component CDN (cara non-React). Pada situs produksi, jika kerangka memungkinkan, kita akan menggunakan @scalar/api-reference-react untuk integrasi React-native. :::

Catatan prototype: Spec di atas sementara memakai Swagger Petstore demo karena spec Kontena hidup di sawala-cloud-core dan endpoint publiknya (https://api.sawala.cloud/public/kontena/openapi.json) belum di-expose untuk anonim — di prod kita akan baik (a) expose spec publik, atau (b) commit spec statis ke sawala-cloud-docs/static/openapi/kontena.json.

Endpoint utama (rangkuman manual)

Method	Path	Deskripsi
GET	/projects/:projId/content/collection/:schemaSlug	List entri koleksi
GET	/projects/:projId/content/collection/:schemaSlug/:id	Ambil satu entri
GET	/projects/:projId/content/single/:schemaSlug	Ambil singleton

Query parameters

Param	Nilai	Deskripsi
locale	id, en, …	Filter berdasarkan locale
q	string	Filter pencarian pada title & slug
publicationState	live	Hanya entri yang sudah dipublish
page / pageSize	integer	Paginasi

Header wajib

X-API-Key: pk_live_xxx

Lihat Cara mint API key untuk membuat token.