Hızlı başlangıç

Bu sayfa, kayıt veya anahtar olmadan birkaç dakikada ilk sonucu almanızı sağlar. Tüm uçlar https://api.mirac-ozdemir.com altındadır ve JSON döner.

Aracı bulun. Her aracın kalıcı bir key’i vardır (ör. kdv). Araç kataloğundan bakabilir veya aratabilirsiniz:
Terminal window
```
curl "https://api.mirac-ozdemir.com/v1/public/search?locale=tr&q=kdv&pageSize=3"
```
Yanıttaki her kayıtta key, title, category ve path bulunur.
Tanımı okuyun. Girdi alanları, çıktılar, etiketler ve geçerli oranlar tanımın içindedir:
Terminal window
```
curl "https://api.mirac-ozdemir.com/v1/public/tools/by-key/kdv?locale=tr"
```
inputSchema.fields size hangi değerleri göndermeniz gerektiğini söyler (amount: ondalık, mode: exclusive | inclusive, vatRateOption: standard | reduced10 | reduced1).

Hesaplayın. Değerleri inputs içinde gönderin. Ondalıklar string olmalıdır:

curl -X POST "https://api.mirac-ozdemir.com/v1/public/tools/by-key/kdv/calculate" \
  -H "Content-Type: application/json" \
  -d '{"inputs":{"amount":"1000","mode":"exclusive","vatRateOption":"standard"}}'

{
  "data": {
    "result": { "net": "1000.00", "vat": "200.00", "gross": "1200.00" },
    "breakdown": [
      { "key": "net", "value": "1000.00", "format": "money", "scale": 2, "currency": "TRY" },
      { "key": "vat", "value": "200.00", "format": "money", "scale": 2, "currency": "TRY" },
      { "key": "gross", "value": "1200.00", "format": "money", "scale": 2, "currency": "TRY" }
    ]
  },
  "meta": {
    "toolVersion": 1,
    "asOf": "2026-10-11",
    "rates": [{ "binding": "vatRate", "key": "tr.vat.standard", "value": "20", "effectiveFrom": "2023-07-10", "effectiveTo": null }]
  }
}

<div data-mo-tool="kdv" data-locale="tr"></div>
<script src="https://api.mirac-ozdemir.com/widget.js" async></script>

Widget, hesaplayıcıyı bir iframe içinde gösterir, yüksekliğini içeriğe göre ayarlar ve sonuçları sayfanıza mo:result olayı olarak iletir. Ayrıntılar: Widget’a genel bakış.

Sırada ne var

Temel kavramlarkey, asOf, version ve ondalık kuralları.

Hesaplamaİstek ve yanıt alanlarının tamamı.

HatalarHata kodları ve yeniden deneme.

Oyun alanıİstekleri tarayıcıda deneyin.

Hızlı başlangıç

Widget ile bir dakikada

Sırada ne var