Tutorial — Blog pertama dengan Kontena

Dari nol sampai blog yang membaca data dari Kontena dalam 15 menit — skema, API key, dan kode fetch.

Tutorial ini membawa Anda dari nol sampai blog yang membaca data dari Kontena dalam 15 menit. Di akhir, Anda akan punya skrip atau halaman yang mencetak daftar artikel terbaru dari project Kontena Anda.

Prasyarat. Akun Sawala Cloud aktif dan satu project di dalamnya. Belum punya? Daftar gratis di sawala.cloud.

Buat skema `post`

Buka dashboard Kontena, klik Buat Skema, lalu isi:

Nama: Post
Slug: post (otomatis)
Tipe: Koleksi

Tambahkan tiga field:

title — Text — wajib
body — Rich text — wajib
coverImage — Media — opsional

Klik Simpan.

Isi satu entri

Pergi ke menu Konten → Post → Buat Entri. Isi title dan body. Klik Simpan, lalu klik Publish.

Mint API key publik

Buka Pengaturan Organisasi → API Keys, klik Buat Public Key, dan pilih project Anda. Salin token (formatnya pk_live_…) — token hanya muncul satu kali, jadi simpan di tempat aman seperti password manager.

Fetch dari kode

Ganti proj_xxx dan pk_live_xxx dengan nilai project dan token Anda.

curl -H "X-API-Key: pk_live_xxx" \
  "https://api.sawala.cloud/public/kontena/projects/proj_xxx/content/collection/post?locale=id"

const res = await fetch(
  'https://api.sawala.cloud/public/kontena/projects/proj_xxx/content/collection/post?locale=id',
  { headers: { 'X-API-Key': 'pk_live_xxx' } }
);
const { items } = await res.json();
console.log(items);

import { createKontenaClient } from '@sawala/kontena-client';

const kontena = createKontenaClient({
  baseUrl:     'https://api.sawala.cloud/public/kontena',
  projectId:   'proj_xxx',
  publicToken: 'pk_live_xxx',
});

interface Post { title: string; body: string }
const { items } = await kontena.listCollection<Post>('post', { locale: 'id' });

Jalankan, dan Anda akan melihat entri yang baru diterbitkan muncul di output.

Langkah selanjutnya

Tambahkan locale en di skema yang sama dan terbitkan versi Inggris.
Pelajari cara mint API key lebih dalam — public vs secret key, rotasi, scope.
Lihat referensi API lengkap untuk semua endpoint dan parameter.