Toplu Dosya Takibi (Batch Tracking)
Bulgaristan vatandaşlık danışmanlığı yürüten hukuk büroları ve acenteler genellikle onlarca hatta yüzlerce müvekkil dosyasını aynı anda takip etmek zorundadır. Resmi portal üzerinden tek tek sorgu yapmak saatler alabilir.
Bulgaristanbot API, toplu dosya sorgulama ve otomatik Excel/CSV raporu oluşturma otomasyonlarını kolaylıkla inşa etmenizi sağlar.
⚡ Temel Kurallar ve Hız Kısıtlamaları (Rate Limits)
Section titled “⚡ Temel Kurallar ve Hız Kısıtlamaları (Rate Limits)”Bulgaristan Adalet Bakanlığı (publicbg.mjs.bg) sunucularının IP kısıtlamasına takılmaması ve sorgularınızın kesintiye uğramaması için şu kurallara dikkat edilmelidir:
- İstekler Arası Bekleme Süresi: Her sorgu arasında en az 1.5 - 2.0 saniye bekleme süresi (
sleep) bırakılmalıdır. - Eşzamanlılık (Concurrency): İstekler paralel değil, sıralı (sequential) gönderilmelidir.
- Yeniden Deneme (Exponential Backoff): Sunucu
503veya504dönerse, 5 saniye bekleyip sorgu bir kez daha tekrarlanmalıdır.
🐍 Hazır Python Toplu Sorgulama Betiği
Section titled “🐍 Hazır Python Toplu Sorgulama Betiği”Aşağıdaki hazır betik, muvekkiller.csv dosyasındaki tüm dosyaları sırayla sorgular ve sonuçları detaylı bir vatandaslik_durum_raporu.csv dosyasına kaydeder.
1. Girdi Dosyası Hazırlayın (muvekkiller.csv)
Section titled “1. Girdi Dosyası Hazırlayın (muvekkiller.csv)”MuvekkilAdi,DosyaNo,PinAhmet Yilmaz,14820/2023,582910Mehmet Demir,9812/2022,410293Ayse Kaya,3411/2024,8819202. Python Betiği (batch_tracker.py)
Section titled “2. Python Betiği (batch_tracker.py)”import csvimport timeimport requestsfrom datetime import datetime
API_ENDPOINT = "https://bgsorgulama.bulgaristanvatandas.com/api/status"INPUT_CSV = "muvekkiller.csv"OUTPUT_CSV = "vatandaslik_durum_raporu.csv"DELAY_BETWEEN_REQUESTS = 2.0 # Saniye cinsinden bekleme süresi
def query_case(case_number: str, pin: str): params = {"reqNum": case_number.strip(), "pin": pin.strip()} try: res = requests.get(API_ENDPOINT, params=params, timeout=12) if res.status_code == 200: data = res.json() return { "basarili": True, "durum_tr": data.get("statusTurkish", ""), "durum_bg": data.get("statusBulgarian", ""), "ukaz_cikti_mi": "EVET" if data.get("isDecree") else "HAYIR", "ukaz_no": data.get("decreeNum") or "", "bot_link": data.get("telegramBot", "") } elif res.status_code == 404: return {"basarili": False, "durum_tr": "Kayıt Bulunamadı / PIN Hatalı"} elif res.status_code in (503, 504): return {"basarili": False, "durum_tr": "Resmi Sunucu Meşgul (Tekrar Denenmeli)"} else: return {"basarili": False, "durum_tr": f"HTTP {res.status_code}"} except Exception as e: return {"basarili": False, "durum_tr": f"Bağlantı Hatası: {str(e)}"}
def run_batch(): results = [] print(f"[{datetime.now().strftime('%H:%M:%S')}] Toplu sorgu başlatılıyor...")
with open(INPUT_CSV, mode="r", encoding="utf-8") as f: reader = csv.DictReader(f) for row in reader: isim = row["MuvekkilAdi"] dosya = row["DosyaNo"] pin = row["Pin"]
print(f"Sorgulanıyor: {isim} ({dosya})...", end="", flush=True) res = query_case(dosya, pin)
durum_ozet = res.get("durum_tr", "") print(f" -> {durum_ozet[:40]}...")
results.append({ "Müvekkil Adı": isim, "Dosya Numarası": dosya, "PIN": pin, "Sorgu Durumu": "Başarılı" if res.get("basarili") else "Başarısız", "Türkçe Aşama Açıklaması": res.get("durum_tr", ""), "Ukaz Çıktı mı": res.get("ukaz_cikti_mi", "HAYIR"), "Ukaz No": res.get("ukaz_no", ""), "Telegram Takip Linki": res.get("bot_link", ""), "Sorgulama Tarihi": datetime.now().strftime("%Y-%m-%d %H:%M:%S") })
# Sunucu koruması için ara ver time.sleep(DELAY_BETWEEN_REQUESTS)
# Raporu CSV olarak kaydet fieldnames = [ "Müvekkil Adı", "Dosya Numarası", "PIN", "Sorgu Durumu", "Türkçe Aşama Açıklaması", "Ukaz Çıktı mı", "Ukaz No", "Telegram Takip Linki", "Sorgulama Tarihi" ] with open(OUTPUT_CSV, mode="w", encoding="utf-8-sig", newline="") as f: writer = csv.DictWriter(f, fieldnames=fieldnames) writer.writeheader() writer.writerows(results)
print(f"\n✅ Tamamlandı! Rapor '{OUTPUT_CSV}' dosyasına kaydedildi.")
if __name__ == "__main__": run_batch()📊 Kurumsal Çözümler & Özel Webhook
Section titled “📊 Kurumsal Çözümler & Özel Webhook”500+ aktif dosyası olan kurumsal hukuk ve danışmanlık şirketleri için:
- Otomatik haftalık durum raporlama servisleri
- Müvekkillerinize özel SMS / WhatsApp / Telegram bildirim köprüleri
- Özel CRM / ERP (Diva, Salesforce, vb.) entegrasyonları
Kurumsal erişim ve özel API anahtarları için doğrudan Telegram üzerinden bizimle iletişime geçebilirsiniz:
👉 @Bulgaristanbot?start=yardim