API berlisensi
API matematika BelajarMatematika.id
Mesin matematika yang sama dengan yang memeriksa jawaban siswa kami: aritmetika rasional eksak, pemeriksa kesetaraan ekspresi, generator soal kembar, dan format angka sesuai kaidah Indonesia.
Akses dan autentikasi
Semua endpoint ada di https://belajarmatematika.id/api/v1 dan memakai metode POST dengan badan JSON. Sertakan kunci di header:
Authorization: Bearer bm_live_…
- Kunci dibuat oleh tim kami dan diberikan sekali. Kami hanya menyimpan sidik (hash) kunci, sehingga kunci yang hilang tidak dapat ditampilkan ulang — kami akan membuatkan kunci baru.
- Panggil API dari server Anda, bukan dari browser. Permintaan lintas situs dari browser ditolak, dan kunci di kode front-end mudah dicuri.
- Setiap kunci memiliki kuota bulanan (dihitung per bulan kalender WIB) dan batas per menit. Header respons
x-kuota-bulanandanx-kuota-sisamenunjukkan sisa kuota. - Kuota awal yang umum: 10.000 permintaan per bulan; dapat dinaikkan sesuai kontrak.
POST /api/v1/verify — periksa jawaban
Kirim spesifikasi kunci (format mesin: titik desimal, garis miring untuk pecahan, tanda pangkat ^) dan jawaban siswa (format Indonesia, mis. 2,5 atau 1 1/2).
curl https://belajarmatematika.id/api/v1/verify \
-H "Authorization: Bearer bm_live_KUNCI_ANDA" \
-H "Content-Type: application/json" \
-d '{"spesifikasi":{"verify":"fraction","nilai":"3/4","bentuk":"paling_sederhana"},"jawaban":"6/8"}' {
"benar": false,
"hampir": true,
"pesan": "Nilainya sudah benar, tetapi sederhanakan pecahannya.",
"normal": "3/4"
} | verify | Keterangan |
|---|---|
numeric | nilai angka (titik desimal), opsional toleransi & satuan |
fraction | nilai pecahan "a/b"; bentuk: bebas | paling_sederhana | campuran |
expression | ekspresi aljabar, mis. "x^2+2x+1"; variabel opsional |
set | himpunan penyelesaian, mis. [2, -3] |
choice | kunci pilihan ganda, mis. "B" atau ["A","C"] |
ordered | urutan nilai |
interval | pertidaksamaan, mis. "x > 3" |
POST /api/v1/generate — soal parametrik dengan kunci
Pilih generator dan seed (bilangan bulat) agar soal dapat dibuat ulang persis sama. kesulitan 1–5; pg: true menghasilkan pilihan ganda. Daftar generator: GET /api/v1/generators (dengan kunci yang memiliki akses generate; tidak mengurangi kuota).
curl https://belajarmatematika.id/api/v1/generate \
-H "Authorization: Bearer bm_live_KUNCI_ANDA" \
-H "Content-Type: application/json" \
-d '{"generator":"faktor.kpk","seed":42,"kesulitan":2,"pg":true}' {
"id": "gen.faktor.kpk.42",
"generator": "faktor.kpk",
"seed": 42,
"kesulitan": 2,
"tipe": "pg",
"stem": "Mega berenang setiap 14 hari sekali dan bersepeda setiap 21 hari sekali. …",
"opsi": [
{ "key": "A", "teks": "$42$", "nilai": "42" },
{ "key": "B", "teks": "$84$", "nilai": "84" },
{ "key": "C", "teks": "$43$", "nilai": "43" },
{ "key": "D", "teks": "$294$", "nilai": "294" }
],
"satuan": null,
"kunci": { "verify": "choice", "nilai": "A", "hitung": "42" },
"petunjuk": ["…"],
"pembahasan": "…",
"miskonsepsi": null
} Respons memuat kunci jawaban. Jangan kirim kolom kunci ke perangkat siswa; periksa jawaban di server Anda atau lewat /api/v1/verify.
POST /api/v1/format — format angka Indonesia
Satu nilai atau daftar hingga 100 nilai per permintaan. Opsi: maks_desimal (0–10), ribuan (true/false), satuan.
curl https://belajarmatematika.id/api/v1/format \
-H "Authorization: Bearer bm_live_KUNCI_ANDA" \
-H "Content-Type: application/json" \
-d '{"nilai":[12500.5, 2.5, "3/4"],"jenis":"angka"}' { "hasil": ["12.500,5", "2,5", "0,75"] } | jenis | Contoh hasil |
|---|---|
angka | 12.500,5 |
rupiah | Rp12.500 |
tex | 2{,}5 atau \frac{3}{4} (untuk KaTeX) |
satuan | 5 cm (wajib isi "satuan") |
satuan_tex | 5\ \text{cm} (wajib isi "satuan") |
Kode galat
Galat dikembalikan sebagai JSON { "error": "…" }.
| Status | Arti |
|---|---|
| 400 | Badan permintaan bukan JSON atau tidak valid (rincian di "detail"). |
| 401 | Kunci tidak ada, salah format, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki akses ke endpoint ini, atau permintaan dikirim dari browser situs lain. |
| 404 | Generator tidak dikenal. |
| 429 | Batas per menit terlampaui atau kuota bulanan habis. |
Lisensi dan privasi
- Akses API berdasarkan kontrak lisensi; harga mengikuti volume dan pemakaian.
- API tidak memerlukan dan tidak menerima data pribadi siswa. Jangan kirim nama, email, atau identitas lain di badan permintaan.
- Soal hasil generator boleh dipakai di produk Anda sesuai ketentuan kontrak; konten materi dan pembahasan situs ini tidak termasuk.
Lembaga bimbel yang ingin platform lengkap dengan merek sendiri dapat melihat paket Bimbel; sekolah dapat melihat paket Sekolah.
Butuh akses API?
Kirim email ke halo@belajarmatematika.id berisi nama lembaga, kebutuhan, dan perkiraan jumlah permintaan per bulan.