Skip to content

Toplu Dosya Takibi (Batch Tracking)

This content is not available in your language yet.

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:

  1. İ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.
  2. Eşzamanlılık (Concurrency): İstekler paralel değil, sıralı (sequential) gönderilmelidir.
  3. Yeniden Deneme (Exponential Backoff): Sunucu 503 veya 504 dö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,Pin
Ahmet Yilmaz,14820/2023,582910
Mehmet Demir,9812/2022,410293
Ayse Kaya,3411/2024,881920
import csv
import time
import requests
from 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()

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