API
DOCS.

Panduan Integrasi Pengembang • REST API v1

← Kembali ke Aplikasi

Ringkasan

Cek Pajak Kendaraan API menyediakan akses programatik untuk mengecek estimasi dan status Pajak Kendaraan Bermotor (PKB) secara real-time untuk wilayah DI Yogyakarta (DIY), Jawa Barat (Jabar), Banten, dan Jawa Timur (Jatim).

BASE URL:
GET

1. Cek Pajak Kendaraan (RESTful)

GET /api/v1/:area/:plate

Path Parameters

Parameter Tipe Keterangan
area String (Wajib) Kode wilayah: diy, jabar, banten, atau jatim
plate String (Wajib) Nomor polisi kendaraan (contoh: AB1234XX, D1234YY, A1234ZZ, L1234AA)

Query Parameters

Parameter Tipe Keterangan
norang String (Kondisional) 5 digit terakhir nomor rangka. Wajib diisi khusus wilayah jatim (contoh: ?norang=12345).

Contoh Request (cURL)

// DI Yogyakarta

curl "/api/v1/diy/AB1234XX"

// Jawa Barat

curl "/api/v1/jabar/D1234YY"

// Banten

curl "/api/v1/banten/A1234ZZ"

// Jawa Timur (Wajib menyertakan parameter norang)

curl "/api/v1/jatim/L1234AA?norang=12345"

Contoh Response JSON (Format Terstandarisasi)

{
  "status": true,
  "is_estimated": false,
  "source": "Official Samsat DIY (samsatsleman.jogjaprov.go.id)",
  "official_note": "Data real-time diperoleh langsung dari server database resmi Samsat Daerah Istimewa Yogyakarta.",
  "data": {
    "area": "DI Yogyakarta",
    "nopol": "AB 2000 A",
    "merk": "HONDA",
    "model": "NC11C1C A/T",
    "tahun": 2011,
    "warna": "-",
    "samsat": "SAMSAT DIY (KAPOLDA DIY / BAPENDA DIY)",
    "pajak": {
      "pkbPokok": 301800,
      "pkbDenda": 0,
      "swdklljPokok": 70000,
      "swdklljDenda": 16000,
      "opsenPokok": 0,
      "opsenDenda": 0,
      "parkir": 0,
      "totalPajak": 387800,
      "tglAkhirPkb": "2025-05-21",
      "tglAkhirStnk": "2031-05-21",
      "aktif": false
    }
  }
}
POST

2. Cek Pajak Kendaraan (JSON Body)

POST /api/check

Request Body JSON

Field Tipe Keterangan
plate String (Wajib) Nomor polisi kendaraan (contoh: "L 1234 AA")
area String (Opsional) Kode wilayah: diy, jabar, banten, jatim. Jika tidak diisi, sistem otomatis mendeteksi dari prefix nomor polisi.
norang String (Opsional) 5 digit terakhir nomor rangka (wajib diisi khusus untuk wilayah jatim).

Contoh Request (cURL)

curl -X POST "/api/check" \
  -H "Content-Type: application/json" \
  -d '{"area": "jatim", "plate": "L 1234 AA", "norang": "12345"}'
GET

3. E-Invoice Permalink & SSR Meta

GET /inv/:id

Merender halaman faktur digital interaktif dan dinamis dengan dukungan OpenGraph / Twitter Cards.

Spesifikasi Pembuatan ID Faktur

  • Format Payload: AREA;PLATE;NORANG (contoh: jatim;L 1234 AA;12345 atau diy;AB 1234 XX;)
  • Encoding: URL-Safe Base64 (tanpa padding =, karakter + diganti -, dan / diganti _)
Input  : jatim;L 1234 AA;12345
Base64 : amF0aW07TCAxMjM0IEFBOzEyMzQ1
Invoice: /inv/amF0aW07TCAxMjM0IEFBOzEyMzQ1

4. Keamanan & Rate Limiting

API Cek Pajak Kendaraan dirancang dengan prinsip standalone architecture, berkinerja tinggi, dan aman dari ancaman siber:

⚡ Rate Limiting Otomatis

Dibatasi maksimal 60 request per menit per alamat IP untuk mencegah flood dan DDoS. Header Retry-After akan dikirim jika limit tercapai (HTTP 429).

🛡️ Anti-SQLi & Anti-XSS

Sanitasi ketat berbasis regular expression pada setiap input nomor polisi dan nomor rangka. Output ter-encode aman dengan header keamanan HTTP modern.

📐 Regulasi Pajak Terbaru

Mendukung perhitungan Opsen PKB 66% sesuai UU HKPD 2025, SWDKLLJ resmi Jasa Raharja, dan tarif parkir berlangganan daerah.

🔒 Standalone Engine

100% self-hosted engine tanpa ketergantungan pada endpoint eksternal yang rentan down.

Developer & Creator

Dimasraw

Pengembang aplikasi dan API Cek Pajak Kendaraan. Kunjungi website resmi untuk melihat dokumentasi, portofolio, dan proyek lainnya.

🌐 Kunjungi dimasraw.my.id →