Dokumentasi API Tool Studio

Akses fungsionalitas tool kami melalui REST API. Semua respons dikembalikan dalam format JSON.

Autentikasi (API Key)

Semua *endpoint* memerlukan API Key untuk otentikasi. API Key harus dikirim melalui *Header* HTTP `X-API-KEY` atau sebagai *Query Parameter* `api_key`.

GET /api/v1/calc/pajak?api_key=YOUR_API_KEY&gaji=10000000

Batasan Penggunaan (Rate Limits)

Pengguna standar dibatasi hingga **1000 request per hari**. Batasan penggunaan direset setiap 24 jam.

Kalkulator Finansial

Kalkulator Pajak (PPh 21/PPN/Final)

GET /api/v1/calc/pajak

Menghitung PPh 21, PPN, PPh Final UMKM, atau PPh 23 berdasarkan jenis pajak.

Parameter (Minimal)

Nama Tipe Deskripsi
tax_type String Jenis pajak: pph21, ppn, pph23, final_umkm.
income Number Nilai Bruto/Gaji/DPP/Omzet.
ptkp_status String Status PTKP (wajib jika tax_type=pph21). Contoh: K0, TK0.

Contoh PPh Final (UMKM)

GET /api/v1/calc/pajak?api_key=KEY&tax_type=final_umkm&income=50000000

Kalkulator Bunga Pinjaman

POST /api/v1/calc/pinjaman

Menghitung angsuran, total bunga, dan biaya pinjaman Flat Rate. Memerlukan body JSON.

Contoh Body (JSON)

{
    "principal": 10000000,
    "interest_rate": 1.5,
    "interest_period": "monthly", // atau "annually"
    "tenor_months": 12,
    "upfront_fee": 500000
}

Kalkulator Gaji Lembur

GET /api/v1/calc/lembur

Menghitung upah lembur berdasarkan Upah Per Jam (PH) sesuai peraturan Indonesia.

Parameter

Nama Tipe Deskripsi
wage Number Upah Sebulan (Upah Pokok + Tunjangan Tetap).
hours Number Total jam lembur (dalam desimal, misal: 2.5).
day_type String Jenis hari: normal, holiday_short, holiday_long.

Kalkulator Bea Cukai

GET /api/v1/calc/customs

Menghitung Bea Masuk (BM), PPN, dan PPh Impor untuk barang kiriman.

Parameter

Nama Tipe Deskripsi
fob Number Harga Barang (USD).
freight Number Biaya Kirim (USD).
kurs Number Nilai Kurs Rupiah terhadap USD.
npwp String Status NPWP (has/no) untuk PPh 22.

Kalkulator Diskon Bertingkat

GET /api/v1/calc/discount

Menghitung harga akhir setelah diskon bertingkat (cascading).

Parameter

Nama Tipe Deskripsi
price Number Harga Awal Produk (Rp).
d1 Number Diskon Utama (%).
d2 Number Diskon Tambahan 1 (Opsional, %).
d3 Number Diskon Tambahan 2 (Opsional, %).

Kalkulator Inflasi

GET /api/v1/calc/inflation

Menghitung daya beli uang Rupiah antar tahun (membutuhkan data IHK historis di server).

Parameter

Nama Tipe Deskripsi
amount Number Jumlah uang awal (Rp).
start_year Number Tahun awal (YYYY).
end_year Number Tahun akhir (YYYY).

Konversi & Utilitas

URL Encoder/Parser

GET /api/v1/util/url

Memproses URL (parsing, encoding, decoding).

Parameter

Nama Tipe Deskripsi
action String Aksi: parse, encode, decode.
value String String/URL yang akan diproses.

Text Case Converter

GET /api/v1/util/case

Mengubah string ke format kasus (UPPERCASE, snake\_case, dll.).

Parameter

Nama Tipe Deskripsi
case_type String Contoh: uppercase, lowercase, snake_case, kebab_case.
text String Teks yang akan diubah.

Movie Database Lookup

GET /api/v1/lookup/movie

Mencari detail film berdasarkan judul atau ID (memerlukan integrasi dengan API TMDb).

Parameter

Nama Tipe Deskripsi
query String Judul film yang dicari.
id Number ID TMDb film.