Sık sorulan sorular

Genel

API ücretsiz mi, anahtar gerekiyor mu?

Public API’yi kullanmak için kayıt veya API anahtarı gerekmez. Adil kullanım için IP başına sınırlar uygulanır: Hız sınırları. Yüksek hacimli veya ticari kullanım planlıyorsanız bize ulaşın.

Sonuçlar resmi midir?

Hayır. Sonuçlar bilgilendirme amaçlıdır ve vergi, hukuk veya finans danışmanlığı yerine geçmez. Kullandığımız oranlar, yasal kaynaklarıyla birlikte yanıtın meta.rates alanında ve araç tanımının rates alanında yer alır.

Oranlar ne kadar güncel?

Her oran bir yürürlük aralığı, kaynak ve lastReviewedAt (son gözden geçirme tarihi) ile yayınlanır. Yıllık yeniden değerlemeye bağlı tutarlar (gelir vergisi dilimleri, harçlar, istisnalar vb.) her yıl başında yeni dönemlerle güncellenir. Geçmiş tarihli hesaplama için asOf kullanın: Hesaplama.

Hesaplama formülleri açık mı?

Hayır. Girdi/çıktı şeması, etiketler, oranlar ve sonuçlar yayınlanır; hesaplama tanımının kendisi yayınlanmaz.

API

Neden ondalıklar string?

Para hesaplarında kayan nokta hatasını önlemek için. "1234.56" gibi string’ler hassasiyeti korur; JSON sayı olarak gönderilen değerler reddedilir. Bkz. Temel kavramlar.

key mi toolId mi kullanmalıyım?

key. Tüm ortamlarda aynıdır ve kalıcıdır. toolId ortama özgüdür.

Tarayıcıdan doğrudan çağırabilir miyim?

Evet. Public uçlar CORS’a açıktır; proxy gerekmez. Bkz. API’ye genel bakış.

429 alıyorum, ne yapmalıyım?

Retry-After kadar bekleyip yeniden deneyin. Tanımları ve arama sonuçlarını önbelleğe alın, aramada gecikme (debounce) kullanın: Hız sınırları.

Bir araç neden 503 MAINTENANCE dönüyor?

Araç geçici olarak bakıma alınmıştır. Retry-After kadar sonra yeniden deneyin; bkz. Durum.

Katalogda bulunmayan bir araç lazım. Ekleyebilir misiniz?

Web sitemizin iletişim sayfasından araç talebinde bulunabilirsiniz.

Hangi araçlar var?

Araç kataloğunda tümü listelidir; ya da /v1/public/tools ve /v1/public/search uçlarını kullanın.

Widget

Widget için API anahtarı veya kayıt gerekiyor mu?

Hayır. Tek satır HTML ve bir betik yeter: Kurulum.

Widget’taki sorumluluk reddini veya bağlantıyı kaldırabilir miyim?

Hayır. Aracın sorumluluk reddi ve tam araç sayfasına giden atıf bağlantısı widget’ın parçasıdır. Başlığı gizleyebilirsiniz (data-header="false").

Widget görünümünü kendi markama uydurabilir miyim?

Evet, belli ölçüde: tema (light, dark, auto ve sayfanızı izleyen inherit), vurgu rengi (data-accent), köşe yuvarlaklığı (data-radius), yoğunluk (data-density) ve dil ayarlanabilir: Kurulum. Yazı tipi veya yerleşimin tamamen değiştirilmesi yoktur. Tamamen özel bir görünüm için Public API’yi kullanın.

Yalnızca hesaplayıcı mı gömebilirim?

Hayır. Hesaplayıcının yanında bir arama kutusu (data-mo-search) ve bir kategori listesi (data-mo-category) de gömülebilir; ayrıca hesaplayıcıyı yalnızca sonuç paneliyle gösterebilirsiniz (data-view="result"): Widget türleri.

Formu önceden doldurabilir veya hesaplamayı kod ile tetikleyebilir miyim?

Evet. data-input-<alan> / data-inputs ile ön değer, data-autorun ile otomatik hesaplama verin; çalışma anında MiracOzdemirWidget.setInputs, calculate ve reset kullanın: JavaScript API.

Seçenekleri değiştirince widget yeniden mi yükleniyor?

Tema, vurgu rengi, köşe, yoğunluk, başlık ve görünüm gibi sunum seçenekleri MiracOzdemirWidget.update ile iframe yeniden yüklenmeden uygulanır; dil ve araç değişince iframe yeniden yüklenir: JavaScript API.

Widget sayfayı aşağı itiyor (CLS), ne yapmalıyım?

Yükleyici bir iskelet yer tutucu çizer ve son ölçülen yüksekliği hatırlar. İlk ziyarette de kaymayı önlemek için data-height ile aracın tipik yüksekliğini verin: Kurulum.

SDK veya React/Vue bileşeni var mı, npm’de mi?

Tipli bir SDK paketi (@mirac-ozdemir/widget: React/Vue bileşenleri, loadWidget, tipler) hazırdır, ancak henüz npm’de yayınlanmadı; kaynak paket olarak kullanılabilir. SDK olmadan da ham yükleyici ve <mo-calculator> özel öğeleri çalışır: Özel öğeler ve SDK.

Widget betiğini sabit sürüme ve bütünlük (SRI) denetimine bağlayabilir miyim?

Evet: /widget/v1.1.0.js değişmezdir ve /widget/manifest.json içinde sha384 özetiyle yayınlanır: Sürüm politikası.

Widget’ı hangi sitelerin gömdüğü kaydediliyor mu?

Evet, anonim ve toplu olarak: embed sayfası gömen sayfanın alan adını (yalnızca alan adı) araç ve gün başına sayar. Girdiler, sonuçlar, IP adresi, çerez veya sayfa yolu saklanmaz: Güvenlik ve gizlilik.

Widget SEO’ma katkı sağlar mı?

Embed sayfaları noindextir; içerik değeri sayfanızın kendi metninden gelir. Araçla ilgili açıklayıcı bir metin eklemenizi öneririz.

CSP kullanıyorum, widget çalışmıyor.

script-src https://api.mirac-ozdemir.com; frame-src https://mirac-ozdemir.com kurallarını ekleyin: Güvenlik ve CSP.

Sonucu kendi sayfamda kullanabilir miyim?

Evet: mo:result olayını dinleyin: Olaylar.