Memulai

Permintaan & galat

Cara setiap endpoint Bitaloka menerima masukan dan melaporkan hasil — pelajari sekali, gunakan di mana saja.

Base URL

https://api.bitaloka.io/v1

Semua endpoint diberi versi di bawah /v1 dan hanya dilayani melalui HTTPS.

Mengirim masukan

Path — pengenal langsung dimasukkan ke URL, mis. GET /v1/nik/{nik}.
Body JSON — layanan teks menerima Content-Type: application/json.
Form multipart — alat PDF dan gambar menerima multipart/form-data dengan file (atau beberapa files) serta opsi sebagai field teks.

Apa yang dikembalikan

Parser, pencarian, dan AI mengembalikan JSON. Alat PDF mengembalikan file hasil proses (application/pdf, atau application/zip untuk split) — tulis body langsung ke disk.

Masukan tidak valid bukanlah galat

NIK yang formatnya salah tetap mendapat HTTP 200, dengan valid: false dan daftar errors yang menjelaskan alasannya. Buat percabangan berdasarkan valid, bukan kode status.

GET /v1/nik/123 → 200 OK

{
  "valid": false,
  "input": "123",
  "normalized": "123",
  "gender": null,
  "birthDate": null,
  "region": null,
  "serial": null,
  "genderConsistent": false,
  "summary": "",
  "errors": [
    {
      "code": "INVALID_FORMAT",
      "message": "NIK must be exactly 16 digits"
    }
  ],
  "warnings": []
}

Galat

Kegagalan sebenarnya menggunakan kode status HTTP standar dan body JSON {"error": "…"}.

Status	Arti
`400`	Masukan tidak ada atau formatnya salah — mis. tidak ada file, atau rentang halaman tidak valid.
`401`	Kunci API tidak ada atau tidak dikenali (setelah kunci diwajibkan).
`413`	Unggahan lebih besar dari 60 MB.
`503`	Dependensi sedang tidak tersedia sementara. Coba lagi dengan exponential backoff.

Batasan

Unggahan hingga 60 MB per permintaan. Penguraian batch menerima hingga 100 item per panggilan.

Memanggil dari browser

CORS terbuka, sehingga halaman web dapat memanggil API secara langsung. Jangan pernah menyertakan kunci rahasia di kode front-end — panggil melalui server Anda sendiri.