İçeriğe geç
Miraç Özdemir Geliştirici

Değişiklik günlüğü

Geriye dönük uyumlu değişiklikler (yeni alanlar, yeni isteğe bağlı parametreler, yeni olay türleri) mevcut sürümde yapılır; kırıcı değişiklikler yeni bir sürümle duyurulur. Bkz. API’ye genel bakış ve Widget sürüm politikası.

2026-10-11

Bölüm başlığı “2026-10-11”
  • Widget v1.1 (yükleyici 1.1.0, protokol version: 1). Geriye dönük uyumludur; mevcut entegrasyonlar değişmeden çalışır. Bkz. Widget sürüm politikası.
    • Canlı güncelleme ve programatik API: MiracOzdemirWidget.update, setInputs, calculate (Promise), reset, get, getResult, unmountAll; version, build ve features. Bkz. JavaScript API.
    • Ön değerler ve otomatik hesaplama: data-input-<alan>, data-inputs, data-autorun, iframe için i.<alan>; yalnızca sonuç görünümü data-view="result". Bkz. Kurulum.
    • Yeni olaylar ve zengin detail: mo:input, mo:select; mo:ready, mo:result, mo:error olaylarına tool, features, inputs, requestId, fields. Bkz. Olaylar.
    • Görünüm özelleştirme: data-accent, data-radius, data-density, data-theme="inherit".
    • Yeni türler: arama kutusu ve kategori listesi (data-mo-search, data-mo-category; target yalnızca _blank veya event). Bkz. Widget türleri.
    • Özel öğeler ve SDK: <mo-calculator>, <mo-search>, <mo-category>; tipli SDK paketi (React/Vue bileşenleri) kaynak paket olarak hazır, npm’de henüz yayınlanmadı. Bkz. Özel öğeler ve SDK.
    • Yerleşim kayması (CLS) düzeltmesi: iskelet yer tutucu, öğrenilen yükseklik (localStorage), data-lazy, preconnect.
    • Erişilebilirlik: yerelleştirilmiş iframe title’ı ve data-title. Konsol uyarıları artık İngilizce.
    • Değişmez yükleyici ve SRI: /widget/v1.1.0.js ve /widget/manifest.json (sha384 integrity). /widget.js ve /widget/v1.js max-age=3600 ile sunulmaya devam eder.
    • Anonim embed kullanım sayımı: embed sayfası, gömen sayfanın alan adını (yalnızca alan adı) günlük toplu sayaçlara işler; girdi veya sonuç saklanmaz. Bkz. Güvenlik ve gizlilik.
  • Widget yapılandırıcı yenilendi: tür seçimi, canlı güncelleme, calculate/setInputs/reset düğmeleri, SRI seçeneği, HTML/özel öğe/iframe/React/Vue/JS API sekmeleri. Bkz. Yapılandırıcı.

2026-10-11

Bölüm başlığı “2026-10-11”
  • Dokümantasyon sitesi yayınlandı. Public API rehberleri, API Referansı, widget kılavuzu, yapılandırıcı, araç kataloğu ve oyun alanı bu sitede.
  • API ana sayfası canlı durum sayfası oldu. https://api.mirac-ozdemir.com/ bileşen durumlarını, trafik özetini ve son 60 dakikayı gösterir. Bkz. Durum.
  • Sözleşme düzeltmeleri. Public OpenAPI açıklamasındaki örnek adresler /v1/public/... olarak düzeltildi ve MAINTENANCE hata kodu hata listesine eklendi.

2026-10-10

Bölüm başlığı “2026-10-10”
  • API yeniden yazıldı (NestJS). Yanıt gövdeleri ve hata zarfı aynı kaldı. Yollar değişti: public uçlar artık /v1/public/* altındadır; eski /api/v1/public/* adresleri kullanılmaz. Entegrasyonlarınızda temel adresi https://api.mirac-ozdemir.com/v1/public olarak güncelleyin.
  • Widget yükleyicisi (/widget.js, /widget/v1.js) ve embed adresi (/{locale}/embed/{key}) değişmedi.
  • /openapi.json, yalnızca public sözleşmeyi (7 işlem) sunmaya devam eder.