Tutorial — Blog pertama dengan Kontena

Tutorial ini membawa Anda dari nol sampai blog yang membaca data dari Kontena dalam 15 menit. Setelah selesai, Anda akan memiliki skrip Node atau halaman Next.js yang mencetak daftar artikel terbaru.

:::info Prasyarat Anda perlu akun Sawala Cloud aktif dan satu project. Belum punya? Daftar gratis di sawala.cloud. :::

Langkah 1 — Buat skema post

Buka dashboard Sawala Cloud di sawala.cloud/dashboard/kontena/schemas, klik Buat Skema, isi:

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

Tambahkan tiga field:

1. title — Text — wajib
2. body — Rich text — wajib
3. coverImage — Media — opsional

Simpan.

Langkah 2 — Isi satu entri

Klik Konten → Post → Buat Entri. Isi title dan body, simpan, lalu Publish.

Langkah 3 — Mint API key publik

Pergi ke Pengaturan Organisasi → API Keys, klik Buat Public Key, pilih project Anda. Salin token (pk_live_...) — ini hanya muncul sekali.

Langkah 4 — Fetch dari kode

curl

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

fetch (vanilla)

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);

@sawala/kontena-client

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 saja diterbitkan. Selamat — blog Anda sudah hidup.

Langkah selanjutnya

• Tambah locale en di skema dan terbitkan versi Inggris.
• Lihat Cara membuat API key untuk detail lebih lanjut.
• Baca referensi API lengkap untuk semua endpoint.