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-bulanan dan x-kuota-sisa menunjukkan 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"
}
verifyKeterangan
numericnilai angka (titik desimal), opsional toleransi & satuan
fractionnilai pecahan "a/b"; bentuk: bebas | paling_sederhana | campuran
expressionekspresi aljabar, mis. "x^2+2x+1"; variabel opsional
sethimpunan penyelesaian, mis. [2, -3]
choicekunci pilihan ganda, mis. "B" atau ["A","C"]
orderedurutan nilai
intervalpertidaksamaan, 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"] }
jenisContoh hasil
angka12.500,5
rupiahRp12.500
tex2{,}5 atau \frac{3}{4} (untuk KaTeX)
satuan5 cm (wajib isi "satuan")
satuan_tex5\ \text{cm} (wajib isi "satuan")

Kode galat

Galat dikembalikan sebagai JSON { "error": "…" }.

StatusArti
400Badan permintaan bukan JSON atau tidak valid (rincian di "detail").
401Kunci tidak ada, salah format, tidak valid, atau sudah dicabut.
403Kunci tidak memiliki akses ke endpoint ini, atau permintaan dikirim dari browser situs lain.
404Generator tidak dikenal.
429Batas 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.

Hubungi kami