> ## Documentation Index
> Fetch the complete documentation index at: https://docs.golansertifikasi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Golan Sertifikasi API

> Panduan integrasi web dan Android serta referensi OpenAPI untuk backend Golan Sertifikasi.

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

| Lingkungan | Base URL |
| - | - |
| Web lokal | `http://localhost:18080/api/v1` |
| Android Emulator lokal | `http://10.0.2.2:18080/api/v1` |
| Production | `https://<domain-api-anda>/api/v1` |

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.

<Warning>
  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.
</Warning>

## 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](/developer-docs/quickstart), [autentikasi](/developer-docs/authentication), dan panduan [Angular](/docs/03-Frontend-Angular-Developer-Guide) atau [Flutter/Android](/docs/04-Mobile-Flutter-Developer-Guide).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.