Spesifikasi OpenAPI
Unduh kontrak machine-readable untuk 17 operasi API aplikasi. Impor ke tooling tanpa mengubah API internal menjadi layanan publik.
Unduh OpenAPI 3.1Di halaman ini
OpenAPI 3.1 · JSON
Gunakan tombol Unduh OpenAPI 3.1 di atas. File disajikan di /developers/openapi.json, tanpa login, dan tidak berisi kredensial atau data akun. Info version mengikuti versi aplikasi, bukan versi URL endpoint.
| Termasuk | Tidak termasuk |
|---|---|
| Akun, preferensi, katalog, quote, order, wallet/ledger, dan top-up QRIS. | Endpoint Better Auth, operator/admin, health, webhook provider, dan scheduler. |
| Method, path, parameter, body, response schema, contoh, serta error yang relevan. | API key pelanggan, /v1, kuota reseller, sandbox transaksi, atau callback pelanggan. |
| Cookie security schemes dan sumber file route. | Nilai cookie, secret, harga live, saldo nyata, atau ID katalog yang bisa langsung dipakai. |
Impor ke API client
Unduh file dari rilis yang sesuai
Gunakan spesifikasi yang disajikan instalasi yang sama dengan target pengujian. Kontrak internal belum menjanjikan kompatibilitas lintas rilis.
Atur server/base URL
Spesifikasi memakai server relatif /. Jika mengimpor file ke Postman, Insomnia, atau tooling lain, ganti origin dengan alamat instalasi sendiri.
Masuk dan simpan cookie
Lakukan alur login Better Auth pada host yang sama melalui cookie jar/API client. Entri type apiKey dengan in cookie pada OpenAPI mendeskripsikan cookie sesi, bukan key reseller.
Ganti semua nilai ilustrasi
Ambil ID dari katalog dan opsi dari quote. Buat UUID untuk intent sendiri. Mulai dari GET dan tinjau dampak setiap POST/PATCH.
Batas tooling yang perlu diketahui
Browser tidak mengizinkan JavaScript menulis header Cookie secara manual. Tool web di origin lain juga tidak melewati pemeriksaan trusted origin. Impor spec bukan cara untuk mengakali autentikasi; gunakan lingkungan same-origin atau API client yang mengelola cookie dengan benar.
OpenAPI memuat bentuk data dan batas input, tetapi tidak mengekspresikan seluruh state machine, harga live, atau keputusan rekonsiliasi. Baca panduan lifecycle dan idempotensi sebelum menghasilkan client otomatis. Nonaktifkan retry mutasi otomatis pada client yang dihasilkan.