Skip to main content
Backend menyediakan satu REST API publik berversi. Angular dan Flutter memakai kontrak dan aturan bisnis yang sama melalui KrakenD; aplikasi klien tidak mengakses service internal secara langsung.

​
Base URL

Domain production belum ditetapkan di repository. Ganti placeholder tersebut setelah hostname API tersedia.

​
Alur integrasi

  1. Tukarkan Google ID token dengan POST /auth/google.
  2. Simpan access token secara aman dan kirim sebagai Authorization: Bearer <token>.
  3. Jika respons login menyatakan onboarding_required: true, selesaikan profil melalui PUT /me/onboarding.
  4. Gunakan endpoint yang sesuai di tab API Reference untuk katalog, pembelajaran, pesanan, dan notifikasi.
Panggil hanya gateway publik. Jangan hubungkan aplikasi ke PostgreSQL, RabbitMQ, gRPC, ClamAV, atau port service internal. Secret Midtrans, S3, dan token antarlayanan hanya boleh berada di backend.

​
Kontrak dan perilaku

  • openapi/openapi.yaml adalah kontrak endpoint utama; halaman referensi Mintlify dibuat langsung dari berkas ini.
  • Otorisasi selalu diputuskan backend. Guard route di aplikasi hanya untuk pengalaman pengguna.
  • Nilai uang menggunakan bilangan integer Rupiah (IDR), bukan angka pecahan atau string berformat.
  • Fitur keuangan dapat mengembalikan 503 saat kebijakan belum diaktifkan. Jangan menganggap endpoint keuangan selalu tersedia.
Lihat quickstart, autentikasi, dan panduan Angular atau Flutter/Android.