API ve Sistem Mimarisi
Bulgaristan Adalet Bakanlığı Vatandaşlık Müdürlüğü (publicbg.mjs.bg), mülakat sonrası adayların durumlarını sorgulayabilmesi için bir web formu sunar. Ancak bu form CAPTCHA korumaları, oturum çerezleri, karmaşık Bulgarca durum metinleri ve sunucu yoğunlukları nedeniyle doğrudan entegrasyonu zor bir yapıya sahiptir.
Bulgaristanbot API, bu karmaşık yapıyı arka planda çözümleyerek geliştiricilere temiz, yüksek hızlı ve yapılandırılmış bir REST JSON arayüzü sunar.
🏛️ Mimari Akış Şeması
Section titled “🏛️ Mimari Akış Şeması”[İstemci / Uygulamanız / Telegram] │ ▼ (1) GET /api/status?reqNum=14820/2023&pin=582910 [Bulgaristanbot Güvenli API Geçidi] │ ├─► (2) Oturum & Anti-CSRF Token Çözümleme │ ▼ (3) Güvenli MJS POST Sorgusu[Bulgaristan Adalet Bakanlığı (publicbg.mjs.bg)] │ ▼ (4) Ham Bulgarca Yanıt [Ayrıştırma & Doğal Dil Motoru] │ ├─► Bulgarca Durum Analizi ├─► Türkçe Çeviri ve Aşama Sınıflandırma ├─► Ukaz / Karar Numarası Tespiti │ ▼ (5) JSON Çıktısı & Telegram Deep Link[Uygulamanız / Son Kullanıcı]💡 Neden Bu API’yi Kullanmalısınız?
Section titled “💡 Neden Bu API’yi Kullanmalısınız?”- CAPTCHA & Oturum Yönetimi ile Uğraşmazsınız: Sistem resmi MJS oturumunu otomatik yönetir ve yanıtı anında döndürür.
- Akıllı Durum Tercümesi: “Преписката се намира в процедура по задължително съгласуване” gibi resmi Bulgarca ibareleri kullanıcı dostu Türkçe açıklamalara dönüştürür.
- Ukaz Erken Uyarısı: Cumhurbaşkanlığı kararnamesi çıktığı anda
isDecree: truebayrağı vedecreeNumalanı ile anında tespit eder. - CORS Desteği:
Access-Control-Allow-Origin: *başlığı ile frontend React, Vue, mobil Flutter/React Native veya backend uygulamalarından doğrudan çağrılabilir. - Yüksek Erişilebilirlik: Modern dağıtık sunucu altyapısı sayesinde kesintisiz ve milisaniyeler seviyesinde hızlı yanıt süreleri.
🔒 Güvenlik ve Gizlilik Prensipleri
Section titled “🔒 Güvenlik ve Gizlilik Prensipleri”- Sıfır Kişisel Veri Saklama: API üzerinden yalnızca dosya numarası ve 6 haneli PIN kodu aktarılır. Kimlik numarası (EGN), pasaport kopyası veya kişisel biyometrik bilgi kesinlikle işlenmez.
- Şifreli İletişim: Tüm istekler TLS 1.3 protokolü ile uçtan uca şifrelenir.
- Hız Sınırlamaları: Resmi MJS sunucularının aşırı yüklenmesini önlemek için IP bazlı akıllı hız kısıtlama (Rate Limiting) uygulanır.