Dokumentasi developer
Pahami kontrak API, bangun antarmuka, dan kembangkan Ping! tanpa menebak perilaku transaksi. Referensi ini mengikuti endpoint yang benar-benar ada di source code.
Unduh OpenAPI 3.1Di halaman ini
API yang ada. Bukan API yang dijanjikan.
Ruang ini ditujukan untuk developer yang mengembangkan instalasi Ping!: frontend, route handler, dan modul domain. Petunjuk penyiapan instalasi tetap ada di README proyek.
Seluruh endpoint aplikasi menggunakan sesi Better Auth dan origin instalasi yang sama. Belum ada API key pelanggan, endpoint /v1, SDK reseller, atau webhook keluar ke pelanggan. Dokumentasi dan file OpenAPI tidak mengaktifkan fitur-fitur tersebut.
| Kontrak | Implementasi saat ini |
|---|---|
| Base URL | Origin instalasi Ping! + /api. Bukan domain API terpisah. |
| Autentikasi | Cookie sesi Better Auth; email + password. Akses resource mengikuti pengguna bersesi. |
| Format | JSON. Endpoint aplikasi memakai envelope ok/data atau ok/error. |
| Nominal | Integer IDR. Harga quote = price_idr; harga Order = price. |
| Versi | API internal belum memiliki versi URL. Cocokkan docs/OpenAPI dengan rilis source yang dipakai. |
| Cakupan OpenAPI | 17 operasi HTTP untuk akun, katalog, order, dompet, dan pembayaran. |
Pilih titik awalmu
Alur integrasi aplikasi
Masuk dan baca akun
Gunakan alur login aplikasi, lalu GET /api/me untuk identitas dan saldo dari sesi yang sama.
Baca katalog dan quote
Ambil ID layanan/negara dari katalog. Minta quote, pilih options[].id, lalu tampilkan price_idr sebelum konfirmasi.
Buat satu order
Kirim satu clientRequestId untuk satu niat pembelian, berikut pilihan harga dan harga yang disetujui. Jangan retry otomatis saat hasil ambigu.
Pantau dan selesaikan
Baca detail order. Gunakan code, canComplete, dan canCancel; setelah aksi, revalidasi order, akun, dan ledger.
Satu referensi, dua cara membaca
Halaman referensi dan unduhan OpenAPI 3.1 memakai definisi endpoint serta schema dokumentasi yang sama. Tes memeriksa route, contoh respons, batas input, dan kode error. Source code route serta service tetap menjadi acuan perilaku sebenarnya.