Skip to content

API ve Sistem Mimarisi

This content is not available in your language yet.

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.


[İ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?”
  1. 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.
  2. Akıllı Durum Tercümesi: “Преписката се намира в процедура по задължително съгласуване” gibi resmi Bulgarca ibareleri kullanıcı dostu Türkçe açıklamalara dönüştürür.
  3. Ukaz Erken Uyarısı: Cumhurbaşkanlığı kararnamesi çıktığı anda isDecree: true bayrağı ve decreeNum alanı ile anında tespit eder.
  4. 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.
  5. Yüksek Erişilebilirlik: Modern dağıtık sunucu altyapısı sayesinde kesintisiz ve milisaniyeler seviyesinde hızlı yanıt süreleri.

  • 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.